dlijgli|tlal 


Educational Services 


VMS System and Network Management II: 
Managing Established Systems 


Student Workbook 
EY-G987E-SG-0001 


Digital Equipment Corporation 


The information in this document is subject to change without notice and should not be construed as a commitment 
by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may 
appear in this document. 


Possession, use, duplication, or dissemination of the software described in this documentation is authorized only 
pursuant to a valid written license from Digital or the third-party owner of the software copyright. 


No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital 
Equipment Corporation. 


Copyright © Digital Equipment Corporation 1991 


Printed in U.S.A. 
All Rights Reserved. 


The following are trademarks of Digital Equipment Corporation: 


BI, Ci, DEC, DECdirect, DECnet, DECsystem, DECwindows, DECwrite, DEUNA, DSSI, EDT, HSC, HSC50, 
LA, MASSBUS, MicroVAX, MSCP, NMI, PDP—11, Q-bus, RA, ReGIS, RK, RL, RM, RP, RSX-11M, SA, SBI, 
TK, TU, UETP, UDA, UNIBUS, VAX, VAXBI, VAXELN, VAX BASIC, VAX C, VAX COBOL, VAX DOCUMENT, 
VAX FORTRAN, VAX MACRO, VAX Notes, VAX Pascal, VAX RMS, VAX Volume Shadowing, VAXcluster, VAXft, 
VAXset, VAXsimPLUS, VAXstation, VAX—11/750, VAX-11/780, VAX 6000, VAX 8350, VAX 8600, VAX 9000, VMS, 
VT300, VT320, XMI, and the DIGITAL logo. 


CONTENTS 
About This Course 


1 Managing Disks" 
INTRODUCTION sc cig on dee acne ie es BORO Ge hw hae 
OBJECTIVES rio3u bedi. cule tad-tca nena pba rene t oheeaka nese 
RESOURCES i542 0.246 ¥ewiarddetew hae e vente bia 2 Poet yond eae ee 
TO PICS cre tt tee ee Cece antnctd HAG an wlaern ie 9 AE tak RATER atnsiie Hin Glee teehee 
REVIEW OF VMS DEVICE NAMES............000 00 cece eee eee e eens — 


DEVICE NAMES IN A VAXcluster SYSTEM ........... 0.0.0... 0c cece eee ees 
MSCP Server 4. javy eeebaaawd eek ee eee al oh a Oa ee a RESON ee Ue we eat 
MADE WIDSCP DELVE 5.5, Sook osie foots os ane clscho vie Bee Bona Be Wek sh Res ae ER PTB, spe Sot 
Device Name Formats ............... We iad Lats oa te Dees Grete Ast Aes ad ce eben Kise Seda SA 


MOUNTING VOLUMES once flies Bees ee te uae b paeehenalele ate meek bie Rim one ae ete § 
Proper Dismount of Disks on Shutdown ............ 0... ccc eee ee eee 
Rebuilding Incorrectly Dismounted Disks ............. 20... 00 cece eee ene 


USING SHOW DEVICE TO OBTAIN INFORMATION ABOUT DISK VOLUMES .... 
CREATING VOLUME SEES i.0% 2.oe8 een wae vada tag toakews eee tee vedo 


USING DISK QUOTAS TO MANAGE DISK SPACE USAGE .................... 
Establishing Quotas on a Volume... ... 0.2... ce ee ee eee 
Establishing Quotas on an Existing Volume ................0 0c cece eee eens 

Disabling and Enabling Quotas on a Volume.................2000000% aavetes 


SETTING FILE CHARACTERISTICS . 5... ccs cece eee eee ee eee bec eees 


a er} 


2 Using Logical Name Tables 
INTRODUCTIONS ..24.02.4.0)69 pate andden.g ih Seamed ke db tp aae es aoe we oes 
OBIBCTIVES 22 cutadecwewinc uae nose een caus Meebeedats eed he agatede 
RESOURCES) sicicruio dat cchasda ness degen seese care eeoemegas samee aes 
TOPICS tahtartrasielvts nics anh seca ea SOM ness eek Seek oleate Weta wR Bats 
LOGICAL NAME TABLES ........ Ria Gti Rites Hiaseh ve Rea cnsnet hark Ser ence tag atic 


LOGICAL NAME TRANSLATION. ........0.0.0.0 0.2 ccc ee eee ene eens 
Determining the Equivalence of a Logical Name ................ 02 eee ee eee 
Modifying Logical Name Translation .......... 0... 0. ccc cece eee eee eens 


DU ARGE ASLO es briny sek ee et as aes ea S ew hee aces ee arc ae 2 


X1X 


Contents-iii 


SYSTEM-CREATED LOGICAL NAMES ............ 0... eee eee ees 2-16 


Process and Job Logical Names ......... 0.0.00 ccc eee cece eee eee eee ee aes 2-16 
System: Lorical Names ss wis 68 Se SOE BE RSA EL SETS ERO EEO O SOAS 2-17 
Redefining System-Created Logical Names ......... 0.0.0. cece ee ce eee eee 2-18 
DEFINING NAMES IN THE SYSTEM TABLE ...............0 20... 02 c eee eens 2-19 
Defining Logical Names Clusterwide ............. 0... cc eee e eee ee eee ee eee 2-19 
Defining Logical Names Permanently .............. 0c cee eee eee eee 2-19 
DURATION OF LOGICAL NAMES ............ 0... ccc eee eee eee e nena 2-20 
SUMMARY: 53.5 c.osue% ot ae tag Oe EAR aed PERSE a eae Rae OM PAS oS odeae 2-21 


3 Queue Management 


INTRODUCTION Y 3.26 4ce hice BEER BRE WE DA REO EOE Cees BEER eres 3-3 
OBJECT OG Wic.2 alee ged ts Ae dene tae: pAb ae Sha Cave oe REG ae Sle eat 3-4 
REOOU ROHS). Sicko Shing bs etal oad hare eons areas eg ene a a ot a ie yk tin eek Bek cot 3-4 
OPICS Sse atx ae pee ONS Se Se ORAS EE Ae OY CEe AOR CESS SAAS OS 3-4 
QUEUE FACILITIES AND OPERATIONS ..........0. 0.0... cc cee eee eens 3-5 
The: Queue Manaser es aos aes a es Sa Se a Oe ON a a eee 3-5 
TYPOS Of Queues oi. 24.54 pieces aire dee Schnee Mua ONO ats Md ee WERE RRS 4 3-6 
EXECULION: CQUBUES oe. fw a8 PE oe SARS 28 ea died ace ea hdl Gieed Ryd, eR SG WEN 3-7 
Generic Queues 26 865 is ss wc AS eae red ane hea & lieve Sed eas 3-8 
HOW THE VMS SYSTEM HANDLES PRINT JOBS...............0.0. 00. eee eee 3-9 
Print Job Scheduling’. 055 2 eho ee oi CAs eos thee bale ees 3-11 
Creating Print Queues «24.46.6650 5b. Py caiesinse ocd obo be ORE Oa SRR we ohne 3-13 
Creating Generic Print Queues ...........0 0... cece ee tenet eens 3-16 
Automatic Queue Creation. ...... 0.0.0.0... 0 cc cece ee eee eens 3-18 
Monitoring Print Queues and Jobs ........0 0.0. ce eee eee eens 3-19 
Monitoring Print Queues’ 665.042 2oo04 85% So eee hs oa WS a Pee Hew es 3-19 
Monitoring Print :J008 4.2 23.5.6 Sal Sa wd Ga OER KEE RE EOE Re REEDED 3-22 
Setting Print Queue Attributes ......0 0.0... ccc ee eee teens 3-23 
Specifying Separation Pages ......... 0... cece eee eee eee ete e ees 3-25 
Preventing Jobs from Being Entered in a Queue .............. 0200: e eens 3-32 
Moving Jobs from One Queue to Another ........... 0.00. eee eee ee eee 3-32 
Deleting a: Queue: ss 2624. sai oie a ewe a cs Os woe a Oh Ca Nae ee 3-33 
Deleting Jobs in Queues. 4.060.254.0068 aa ne dds Veale FORM he eens 6 eS 3-33 
Handling Print Queue Problems ................. 0 ee eee eee eee ee eens 3-34 
HOW THE VMS SYSTEM HANDLES BATCH JOBS .............. 0.0000 ce eee 3-35 
BATCH QUEUL OPERATIONS 4450445 ¢ cawha wok PEG RR EAMETS See 3-37 
Creating Batch Queues ...............000005 Leet u os ea ate OS eee eoda eee eee 3-37 
Stopping Batch: Queues: ois.5 5.5.4 4-oas ata ns AG ORS eS Ea ee AS 3—40 


Contents—iv 


MANAGING BATCH AND PRINT OPERATIONS IN A VAXcluster SYSTEM ....... 3-43 


Distributed Queuing ... 0... ccc cc ccc ee emcee eaten te teeeeeees 3-43 
Setting Up Cluster-Wide Queues ......... 0... ccc eee eee nee e ees 3—44 
Setting Up Cluster-Wide Batch and Print Queues .................00 00 aes 3—44 
Examples of Creating Cluster-Wide Generic Print and Batch Queues .......... 3—45 
Creating a Cluster-Wide Generic Batch Queue ............ 2... ccc eee ee eee 3—46 
Common. Qucue Startup sous oes $2 6 4 8486 awe wea oe ead dee Peds 3-47 
SUMMARY: ysis eda oot aneu sneha ec abe emw st eh Css Peale teaw ars 3-48 
Overview of Queue Commands ......... 0... ccc ce ete ee ee eee ne nnes 3-48 


4 Performing Backups and Restores 


INTRODUCTION vy tic tacnd aces ke Oe Rae Ae Pe a eG ek Oe eee eee 4-3 
OBIE CIV GS: Jyefe. ait dana Sig OO a Hea anksuchin BAS ee Sema aw Ss dhe Meat iat ata ei ite Re ee 4—4 
RESOURCES noe side ou whedon ed his eae d bea da es As teed Se hese 4—4 
PREG ve Necnck coisa td. a ak ves fet th eh bee hh tae Bos Hes een tehetigd be Ba es Read Dt dl tay wae Da As es ED, A aN 4-4 
MAKING BACKUP COPIES OF FILES .......... 0.0.00. ccc cc eee eens 4—5 
Image and Incremental Backups ............0 0... cece cece eee eens 4-5 
DAVE DEUS 6 cacu noes eo ee Oe ae we een ee Re Rtn a ee eet 4—6 
Using the BACKUP Command to Save Files ....... 0.0.0.0... cece eee eee 4—6 
Making Image Backups of a Disk .......... 0.0.0. cece cee eee 4—7 
Making Incremental Backups of a Disk .................0 00 ce eee DGD or Sah we 4-9 
USING COMMAND PROCEDURES FOR BACKUPS ..............0-0 0c eeuees 4-10 
Command Procedure for Nightly Image Backups................. 000 eeeeuee 4—10 
Command Procedure for Nightly Incremental Backup .................200000% 4~—11 
RESTORING FILES FROM BACKUP COPIES..........0. 0.0.0.0. 0 cc eee eee 4-12 
Restoring Files from an Image Backup ........... 0.2... e eee eeee 4—13 
Restoring Files from an Incremental Backup............0.00 000 cece eee eceees 4—15 
LISTING THE CONTENTS OF A SAVE SET ... 0.0... 2... ce ene 4-17 
SUMMARY j.2crcGomrdeys odbc eee aed bod ee een eee ae eae 4—18 
APPENDIX - BACKUP QUICK REFERENCE TABLES .....................00. 4-19 


5 Introduction to System Customization 


INTRODUCTION pon csactnd duh us asd van ka Sami ede na ene nan deade 5-3 
OBINCTIVES) rire tauantasastuuiell eiathan Bergan ducmaice oneness aoe: 5-4 
RESOURCES ournsioninceatesatr base baler euabiuen tesmenaansatet eee 5-4 


TOPICS: 55 bG dG tin Pact Sane RoRe bs Core ee ee RAGE RA Nets AE tee wala Re eS 5-5 


Contents—v 


SYS LEM SAR EUR BINS eke Gicy Sele wens cs ete ae coe acawa ee arenes 5-6 


Site-Independent Startup Piles’ avenke ad ake te ty Eee Se re AGRE eS et OR 5-7 
SYSSSYSTEM:STARTUPCOM: 6:s6-6.0.040 60 dese S4-dain Sods BEM OM OSS ES Sa 5-7 
Connpuring Devices: is. 2 oe katr ht Caw a bw OEE Se OE Gee Ed Be ES EGS es 5-8 
SY CONPIG: COM oo auction oe by eet Ss dR EE RE HER ODA ESE URES 5-8 
Defining System-Wide Logical Names ......... 0... 0.0 c eee eee ee eee eens 5-9 
SYLOGICALS.COM ........... Pe OR ee ee ee eRe ree 5-9 
Executive-Mode Logical Name Requirements. ........... 0.00: eee eee e eens 5-11 
Installing Paging and Swapping Files ........... 0.0... ccc cee eee eens 5-13 
Si PAGS WPPILES.COM. 4:5: s5. 565. e cate ee ee RRAG Re PERO ee bere teks 5-13 
General Site-Specific Startup Functions... ........0 0.0.0.0. c eee eee eee 5-14 
DLOLARLUP VOCOM 635g oe 8 ed ok ae Oe Hed Aaa GW ae Re LW ne i 5-14 
Login Command Procedures... ......... 0. cc cece eee eee e ee tee eens 5-16 
Setting Up a Captive Account .......... 0... ccc ce eee e ence reece 5-18 
MAINTAINING SYSTEM PARAMETERS ...........0. 0.00. eee tenes 5-19 
Utilities for Maintaining System Parameters .............. 00. eee cee eee 5-20 
System Generation Utility (SYSGEN) .........0. 00.0... ee eee 5-20 
AUTOGEN Command Procedure ........... 0.0... ccc eee cece tet ee eeee 5-20 
System Management Utility (SYSMAN) ..........0...0 0.00.00. cc eee eee 5-20 
Changing Physical Resources. .......... 0.00. t eee eee eee eens mace ae 
Reconfiguring the System with AUTOGEN .......... 0.0... 0. ccc cece eee 5-22 
Runnite AUTOGEN © sista OC Ake ds CSO ERS ORE SOY OR OSE od EER aed 5-24 
Modifying System Parameters Without Changing File Sizes ................. 5-24 
Changing System Parameters and File Sizes............ 0.000.000 00 eee eee 5-24 
SYOMAN PARAMETERS 60 wid ened ee be wwe SEE Pek ok aOR 5—25 
Switching Window Systems .......... 2.00. eect cence eens 5-27 
DU MMAR. 62.06% oa oe Be eee du Meese Sao OS ane et eRe Lae y Sea 5-~28 


6 Layered Product Installation 


ENT RO DUCTION 32a wow nae hes GaGa gS Ath os BPS ind da hae he te a ae x 6-3 
OBIBCTIVES! cutee cata bane heen h peed teeta Rawat s oheh ae Ae 6-4 
RECOURCHS ~ itn abp wae Peewee see Meee eee oeee eh T es Eee 6-4 
SOA eco et scenes ieee pce SOL tn Thatch ese gg se Ge toate we sy Bas es a esheets Ge aon 6-5 


OVERVIEW OF OPTIONAL (LAYERED) SOFTWARE PRODUCTS INSTALLATION . 6-6 


THE LICENSE MANAGEMENT FACILITY (LMF)............0 0.000000. eee eee 6-7 
MANAGING PRODUCT LICENSES ......... 0.0.0.0 ccc eee eee eee 6-8 
Overview of the License Management Facility (LMF) .....................0.0. 6-8 
Components-of the LME ss ¢<24 reed etn ly GG watawe Ha 8a eee oe ee PRS oes 6-9 
LICCNSE WINIES occa naneG oe cur hehe pie koa e ee ee eee se Oe hehe Res 6-10 

The License Management Utility (LICENSE) .............. 0.0... 0.0 ce eee 6-12 
LICENSE Subcommand Overview.............. 0.00 ee eeeee eed seh ge slacess 6-13 


Contents—vi 


INSTALLING LAYERED PRODUCTS ............ 20... cee ee eee eee eee 6-17 


Adjusting User Privileges and Quotas .. 1... 0.0... cc eee tens 6-17 
Quotas and Resource Limits ....... 0.0.0.0... cee eee ee eee eee 6-18 
Adjusting SYSGEN Parameters... 1... 0.0... nett eee nes 6-19 
VMSINSTAL Installer’s Options Overview ........ 0.0.0.0 cece eee eee 6—27 
INSTALLING LAYERED PRODUCTS ON A COMMON SYSTEM DISK ........... 6-28 
SUMMARY: «23th ets aah re Sw eke sO EE hie ase re Se Se eee woe 6-30 
APPENDIX - LICENSE UTILITY SUBCOMMANDS ...................000000: 6-31 
PIVEION Dyes ea ik op ata hon chi wh aeaaan eee ah Bree AER DCRR ORE Ale ORS eee 6-31 
CANCHE: & 4 b5Ga aoe 40x Oren th GO oe eh ee atten tee tebe 6-31 
COPY sce ack ea Rat ak pistes eee on We ORS Eh aia SEI a 3 6-32 
RUA Bie to vt hie Bie hs serade elt anes auld Pata Ad tis FG aise ta teatatee Web eileen ech golae Une oa ote 6-32 
DDI EET: tc Gee RS hd ote kee S Uae a al od Gale ed Dene Seen OEE Ee wSe 6-33 
DISAB ion arsthaear inv ahd. <i Whe ee Sunes BS ea ee eee ee ee Se ou 6-33 
BNABIGN 2 0.6 s!ed tos ble thee thie ace ae ws A cates ae a ae awe ed eta 6-33 
DST oils, 4a eS ahaa AWE Ga ak. te Niece te aod Bo aceite Bet Una nes Goactent lege dade 6-34 
Daag ced Cee Gee ise hw SIG Ra oR as ts DR es He ee OS perce aee 6-34 
BORD ce oi cacg eo ie ow UO EE A ERE Died ee he ewes Baas tee Oe aes 6-36 
MOD TON: (gtitles a Selneiee aguante d 4 oa Snh ede ae rw ad Eee as ace Aub eae ee oe 6-36 
IV Ve ake ae at Me ae hr cea falls aA Mee geta Shs Eta ae tee eis ea eae dane ele areal ene A ad 6-37 
REGISTER 23 tac oe bot et eeua dade kus wut the svi -s #4 oad ae ee oe ee 6-37 
SPAR a, cuts Geena aa keane baa bees Be en ah tod aM ete pent ee 6-38 
OND OAD ratte Nitec a eed getrein ee Boe Mea bay ieee eb ie ca ae ee 6-38 
MVS SAO a acid i se Sele epigastric dn ln aaa ie wht 6-38 


7 Reporting on User Activity 


INTRODUCTION a.tcasare baw eee eee bedi t Yank See Soe bao Bohs Os 7-3 
OB CLV Ue etic ob rear ein a BE ee ea Oa eee healed Meta x eae 7-3 
RE SOU RC Minn sont ohe nad Weyl adig Boi eared ace Bata ROE EN SAWS OS GIRE WS 7-3 
OVI Site 5 a tncts Suite Bah Beate wd woke wired bat oa dik bone sida ds bose oa aoe eee ee 7-3 
COLLECTING PROCESS INFORMATION WITH THE ACCOUNTING UTILITY .... 7-4 

TMA ge ACCOUNTING: sind 2.202 sce seen reap ae pee oS Oe ae HS em Ee SS 7-7 

Using the Accounting Utility to Produce Reports................00000 cee eeee 7-8 
SUMMARY 10.25 6 ee otantne dg ote dc haeiaded bes wale ate hae aa we ees 7-18 


8 Maintaining System Security 


INTRODUCTIONS «2.45 Auateacate beta ithaca uated has beeaeaiasanaes 8-3 
OB NCTIVis 524 ote eats oth St ash aoe edad undead deumae 8-4 
RESOURCHS wt cauntcorah enna ssesea coins ausaue eine ara e ada: 84 
TOPICS 205 ite ct acids faa aes aie coe ea ais Len ee atest. 8-5 


Contents-vii 


PHYSICA; SECURITY. 2. i 6 po tic'o a baie be ee Oe eNOS LEER RAS Roe eee ES 8-6 
SOPTWARE SECURIDY: sc. .eaGner eae bias Cae he eeu eel eee ee es 8-7 
VAXcluster Security Considerations......... 0.0... ccc cee ee eens 8-8 
Pile: S€CUrty 244.0659 sae Gine ele Wy hoa 8aG waa EOE pane he he hie AEE E Uae es 8-9 
Erase-On-Delete and Erase-On-Allocate ......... 0.0... cc eee eee ee eens 8-9 
OGIN- SRCURILY =u, 3 !s.o nary Steele ee alee dinars el acne eee aan ey nae ean 8-11 
System: Passwords: «50's Go-Go O54 e0k 6 Ww eo Seam we Bea da SM RE ek 8-12 
Password USave:s oncdy eno se padineraee eRe S SS Ce eee ER RRS EES 8-13 
Pilterinp Passwords: «2255s 5-4 fof ere, Shs es SBE he es OS Hd Re RS 8-14 
DICHIONATY DEANE hc, cm osu a Se He ae eal Le Sih Sie 3 ae ete Bo ee ee se 8-14 
History Car havin 6 ak ech ooo ea SAS SRE One hee TECHS Sarthe a 8-14 
Protecting Terminals and Other Nonshareable Devices .................200005 8-15 
Password Collection Programs ........... 0.0. ccc ec e ec e eee een eens 8-16 
Break-In Detection at Login... 2.0.2... 0... eee een eens 8-17 
PLUG Cr ISS 6 eb gh ho IS ek hw EOS OL LE EE EO rs Pe & 8-20 
Clearing Intrusion Records: 2.22 42:5 e.0046 daw an bohue be die o ee see O he wR 8~22 
UIC/AND ACE PROTECTION icin 4n 004th eid oe Ra AURORA CARS RE Oa YS 8—23 
VMS Protection Usine UICS: si iocnn esta bow hee ea ok Be en BA eee 8-24 
VMS Protection Using ACL Se. o:5'0o15 bad hh knead ow ag he ee ee ete Rd peal es 8-27 
TAILORING USER ACCOUNTS 22 co% ed civh sds She SEG ESOS Ow STEER REO 8-28 
Access anid Security: PIGlds = 2.4. c1% orb dne Oe Re rk  A ED Fe OS SES 8-29 
Access Times and: Modes 3.20.63 cde sense Se ae hl 4d wes RE a AAR ees 8-29 
opin Wlags. 3682s eon d Sem bebo wb LRG SSSA A heed % dn cea be ties 8-31 
DeCrIty MIGIAS 1.0% ey se he Ree Oak aw lek ahs Pee Pee beam ee 8-32 
PPIVUCHOS cn 5 oe Gas Burs YY Sea Alo ebiS New Ue atihen Or ba aia Saya sew dae awe Bea 8-34 
CONVERSATIONAL STARTUP 6. jig OFS. ESR OSE. He ASKER REED ASW eRe 8-37 
Bypassing the User Authorization File ........ 0.00.00. 0 cc cee ee eee 8-39 
DUIMNARY. sepas7.2 ereurcart baie aaa seo tehasta eee eae ia era ee teas 8-40 
9 Managing a Network Node 

INTRODUCTION bins treet ae «ee hte dk SAGE EEK CAUSES RO GA awe es eRe ERS 9-3 
OBJBCTIV BG 43 .a5 sso Aten See Ree ead Fa ene ta Oa ew ES 9-3 
FORO) RC ogee 6 Ge cores este aise chau for to a Hei a 6 ee lee cel ec eve a nl de Be re hae eves eed 9-3 
TOPICS: cae See ara eee BORO ede Noe OSS he 04 We a SS ewes ee 9-3 
REVIEW: STARTING, STOPPING, AND MONITORING THE NETWORK ......... 9-4 
Starting tne Networks.) is4.4 44.5 sew eienw ees oko eRe toners died eaawe DA 9-4 
topping the Network: ju. 40ce bare wed eek cheer aw so eet ud coke ks een 94 
The SHOW NETWORK Command ............. 0.00: eee e eee e eee e eens 9-4 


Contents—viii 


DECnet CONFIGURATION DATABASES ............ 0... cece 9-5 


Permanent Database 0050s hehe ay See et eee AW LSE MOR MES BE RS 9-5 
Volmtile- Database oo csacs, 3 ad thy ee we PIER ae ele eb I ORS Ee eee eRe 9-5 
Maintaining the DECnet Configuration Database .............. 0.0000 eens 9-6 
identifying @.NOGG o64 335 eee ba eas Bule Seen ad aoe ee he ez 9-6 
NCPOV ERVIEW 22.9. 0. 24 dui a ie gah head wee eta Ga ee ee a ae 9-7 
Invoking: and Exiting NOP ooo facut ees ete Soe sehen we SONOS ESA eee WES 9-7 
DECHEP Privileges o%.2.66 0 bance 4 6 ERS SOM OOS PEER O REO ES Meee Mees 9-8 
MAINTAINING THE REMOTE NODE DATABASE .............. 0.2.00: e eee 9-9 
Adding Remote Nodes to Your Configuration Database .................000005 9-9 
Copying Known Nodes¢ «203.5460 5-44.26 e0 Bee ee habs heme bed cee « 9-11 
Removing a Node from the Database........... 0.0... cece eee nes 9-12 
Changing Remote Node Entries ........... 0... ccc eee ee ee ee eens 9-13 
EXECUTING REMOTE COMMANDS.............00 00 cece cee ee eee eee 9-14 
TEL COMmMand < +.42.3:00 cng whoa a Ue Sek eee eee ew eho Sidae eds 9-14 
Setting an: Nxecuter Nodé so. 42 ocuniwe Gn eae Aten e CERSU es Eh Sele ee Eek ESS 9-16 
Indicating Access Control for Remote Command Execution.................. 9-17 

SU MAY. os turnin or Ma os ah hare & alee Rad Gene ee Ge OED nee wath keris a 9-18 


10 System Monitoring 


INTRODUCTION sacs i te cei jee eie vend Meee Macey ey aweedee ee eR EAS 10-3 
OBJEC ULV IS tise cing Males ad bea nO el kee Stars Ea Ee BAe oe ROE 10-4 
RESOURCES 264 0s.s ace Ro0ce beet Avice bed $04 bea eas Dies He ee 10-4 
TOPICS: fed Sex cod oyna dopheotoa Gash dich byk Geel Oar ie Re Soy elec Wirth AIS tw Od en 10-4 
MONITOR WU PHGIY ct te ont eek fad ee Pee OR FORGES BO Oe RAR TES DANS 10-5 
Using MONITOR in a Network ......... 0.0... eee eens 10-9 
Using MONITOR in a VAXcluster System ..... 0.0.0... 0.0.0 cece eee nee 10-10 
Command: Procedures: xX 2554/52 ss eg aie Wt 2 Baele Guild e ON oe aiid Soka dae 10-13 
MONITOR Command Summary ............ 0... cece ee eee ee eee eee 10-14 
MONITORING WITH DCL COMMANDS ............. 0.0.00 ccc cece ee eens 10-15 
Memory Resources sige) o£ de SS bi ha Mae o Ow Oe atd aR ea bees 10-15 
SHOW SYSTEM Qualifiers: «6.0% scene ye haig 6 6 SS BOE RRR eS SE Se ES 10-17 
SHOW PROCESS/CONTINUOUS Command ................ 000 e eee eee 10-19 
USING THE NETWORK CONTROL PROGRAM (NCP) FOR MONITORING ....... 10-20 
SHOW and LIST Commands: «6 csc ooh 5 hs 4p he ie SSG CERO ELL SES RA 10-20 
SHOW, LINE Command i a.con ne tae eas wa eee oad 6 MOMs SA Gees aces 10-21 
Identifying Lines. 20244 20:¢heu-e ae he4 C8 Wad eee ee hae sew SG eee eM ew ROS 10-21 
Circuit; COMmmMANGS: 65.6 2 55 i ora oth oe Sh0 VORA ahaa OL MOE ee Sele PARR 10-22 
Idenmtitying Cwrcaits) 6. aoe ae hee ete hy ide oa Re eee Ee ES BE 10-22 
SHOW-LINKS: Command)... 5.3.22 avch tad otluwat ecco ates awe eae New en ae 10-23 


Contents-ix 


USING SHOW CLUSTER IN A VAXcluster SYSTEM .......... 2.0.0.0. cece eee 10-24 


Adding and Removing from the Display...........0.. 0000 c cece ecu cee eee ees 10-25 
SUNMARY. c.5.4:5 4 teeth aS ak ee ane eee ROOT OLE OPS ee 10-28 
PENIS Spiel tog de OS ise wrseiedhs ak wh See hut OS sissy Mee Send So te eT eS, re Ge 10-29 

Monitoring the System Command Procedures ..............0 00 eee cece eeeee 10-29 

Command Procedure for Monitoring the VAXcluster System ................... 10-33 


11 Developing Command Procedures 


EN TRODUCTION <6. ces ok scot owe SEG k Sos eas AE eae ek Kae 11-3 
OBIE PIV GS: = 2.05 osech le, oi ke Go Sane ea bh Bleth Se Sie ham Aue nen ee Gene Sadi lok 11-3 
RESOURCES o8 fee eae ne ee bie dr bs See bed hve SS 4 Cov aiwa Daw dee. 11-4 
OPI CS Gai @ date salt Caregen 4a teen oa a eS aE P Otek Wi Oe A Sine Boats 114 
REVIEW OF COMMAND PROCEDURE GUIDELINES ........................ 11-5. 
Steps for Developing Command Procedures ............... 00 cece eee eee e cease 11-5 
PASSING PARAMETERS TO COMMAND PROCEDURES...................... 11-7 
* MORE: ON-S YMIBO LS: adits diate ek Sure he bebe mba ew hea Wa ee ee aS 11-9 
TERMINAL VO 664.28 243e-nesho eleee aed hee en ee et ane ae On eae ee ar 11-11 
Controlling Terminal VO <3 4466.52 Said ed fond Ob drew Roe ete Roane ks 11-12 
Displaying Information for the User on the Terminal .....................04- 11-13 
Getting Information from the User .......... 0... 0c ccc ec ee cee eee 11-15 
MORE USES FOR:SYMBOLS << 25. 26:-4 oe eicdtacs Sa be ee he oe be eee as 11-17 
Symbols Used as Variables in Command Procedures................000000008 11-18 
Using Symbols to Manipulate Data ........ 0.0... 0. ccc ee ee ',... 11-19 
Manipulating Strings {6:5 5.0163 dnd cig epee ag we ded Sy Piao h eye Rios es 11-20 
Manipulating Arithmetic Expressions .........0.0 0.000 c cc cee eee eee teens 11-21 
Using Symbols to Test. Data crc eh ae eee hee oe RK Se ORE ROS 11-22 
COMPATiie SLINGS 55.04. 8s wish bee eee ee wee Cone ee oe Re OTS 11-22 
Comparing Arithmetic Expressions ......... 0... 0. cc eee ce eee cee eee ees 11-24 
CONTROLLING THE FLOW OF EXECUTION ........... 0.0.0.0... 11-26 
EP Command 2.365.405 waite s ewe none eee? on a we eek wos ewet 11-27 
Evaluation of Expressions in IF Commands .................000 cece eeeuee 11-28 
GOTO Command: iid ye alates 266 os Sth wow fous Sok bees aie ee ews 11-29 
TLeralive: Procedures .ci0:0600 5 cod, ood tae ark CGA ha awh ee ee weds 11-30 
USING LEXICAL FUNCTIONS TO MANIPULATE DATA ...................... 11-31 
DUMMARY. :6.¢-bcwh ove wend esau be eae e pad Hee ele Bae WE a eae 11-35 
APPENDIX — ADVANCED DCL TOPICS ..........00 0.00... ccc ce eee 11-36 


Contents—x 


BE Oe sure ce Sods greta a. tind ieianig Geese aw bap Ow ent gn aea A Gre eo cabs gla aed aon Ue 11-36 


Opening a Filters as 56 ates od atans Mad Ae PERS Ed eee REE eee ees 11-37 
Closing a Mil@r = ¢2s%. 85 ce 8 care toe eee trea Gee OA ee se Ae Sele d Lh sae ae 11-38 
Reading AON a BN oth 6 G5, ete Ug in ge eae Aes BS eta aes A Oe ee Sasa 11-39 
WTICINE CO GG 2s den. hed rer data: aw dd ad a ee aoe aoe SEY gga eke he Rael 11-40 
More Uses for System-Created Logical Names........... 0.0... cece eee eee 11-41 
BHOW OF CONTRO Ii 335 vous o:cb4 ks Bea ees BE aed OE AER DEA AS eae ee 11-43 
CARE) Cominrand. 2 ata 6i tia da Get ace pi bs Sh Bea Moat Ge ach We pcg PO Nd Gr eeca ee lg eee 11-43 
SUBROUTINE and ENDSUBROUTINE Commands..................000000% 11-43 
GOSUB- Command 4.564.5.5%-o5.465.8 bod ces ce wei hy tobe koSh6 doe eS 11-44 
EETOP PAN GUNG esas a ae edie ee Ae eat we a Oke ne ew eee 1146 
babies ONCCK oe sue dik Save hha eds a RRO Wolo Shea td ake ete eee ee 11-47 
ON Commands os. feces S ote Sach wee Se SNE ie OO OER CEPR ERRORS ME 1148 
SEE INOON Command: 2200 UAcaaseseariicg Ake be SHS ee ER ae a Mae 11-50 
ON CONTROL. Y Interripts 223 sechceee swt Lo MEY Oe Aho oe See Sew 11-51 
SET INGOCONTROLESY. se.0.60 Sia bl hse ah ee we WS ea RS ee PE oS he 11-51 
Handling Pile VOR rrors 2.04.5 v9 64 be eed oA 4 CAAA eee es twee eae 11-52 
USING SYM BOUS 6 tind 5.2 bea ee Raton BOERS ASE ee REL S 11-53 
Accessing Local and Global Symbol Tables .............. 0... eee eee eee 11-53 
Command Gevels-4.c3.0025.5 wadrert oes eed a hoa cae et oa ae aa: Mokke ee 11-53 
EGcaSymbOls. 54.9. Plewy eth es a ass an ees Moe cesd BE Me ee MER eS AS 11-54 
Global Symbols: 2..4.2 30.0%06 dvs daeead teed de wensdears Ceses oad er eee eee 11-54 
Phases of Command Processing ................- 00 eee eee eee eee teen eee 11-56 
Using Symbols to Format Output ........0.0 0.00. cc ee teens 11-57 
Creating Character String Symbols ........... 0.0... cece eee eee cette e eee 11-57 
mtrne Overlave ..ccA5ee ete ce hha Reed ae a me aed pee ae enemas 11-58 
Anthmetic Overlays .<sce¢ 04-4 ise bo pny eo bee fe ot RODS Le Ee das 11-59 
BEX AL FUNCTIONS *. «5.5 a: 25,45 db Scand pone ed & det Bie Ow od ae BE b RR RG ee ied 11-60 
Process Information Lexical Functions. ........ 0.0.0.0. ce eee eee ee eee ees 11—60 
System Information Lexical Functions ..........0 0.0... cece eee ee eee 11-66 
Character Manipulation Lexical Functions ......... 2.0.0.0... cc cece eee eee 11-70 
File Information Lexical Functions ...........0 0.0. ccc eee eee eee eens 11-75 
12 Written Exercises 
QUEUE. MANAGEMENT o.4)s-¢gbot. condi neds e 2 oink exes eeeadd Gene Rowe ee 12~3 
Written Exercise 3-1 — Queues .......... 0. cee eee eee eens 12-3 
Solutions to Written Exercise 3-1 — Queues ......... 0.00... cece ee eee 12-4 
Written Exercise 3-2 — Queue Creation ....... 0.0.0... eee ee eee 12-5 
Solutions to Written Exercise 3-2 — Queue Creation ................0 00 eee 12-6 
MAINTAINING SYSTEM SECURITY ........ 0.00.00. ccc ee ee ee eens 12-7 
Written Exercise 8-1 — Process Parameters ............ 0.00 e cece eens 12-7 
Solutions to Written Exercise 8-1 — Process Parameters................0-2005. 12—9 


Contents-xi 


13 Laboratory Exercises 


INTRODUCTION fs coca ete 34a eke & ESAS Sens LOM eS Pees Bee eas 13-3 
LABORATORY EXERCISES — MANAGING DISKS .............. 00000 eeeeeee 13-5 
Laboratory Exercise 1-1 — Devices .......... 2... cc ccc eee eee eee eee eens 13-5 
Solutions to Laboratory Exercise 1-1 — Devices ............ 0.00 cee eee eens 13-6 
Laboratory Exercise 1-2 — Devices .......... 0.0. cece eee eee eect eens 13-7 
Solution to Laboratory Exercise 1-2 — Devices ............. 0.0 e eee eee eens 13-8 
Laboratory Exercise 1-3 — Disk Quotas ........... 0... cece eee eee eee eee 13-9 
Solutions to Laboratory Exercise 1-3 — Disk Quotas...................-..20-. 13-10 
LABORATORY EXERCISES — USING LOGICAL NAME TABLES ............... 13-13 
Laboratory Exercise 2-1 —- Logical Name Tables ....................2- 000005 13-13 
Solutions to Laboratory Exercise 2-1 — Logical Name Tables .................. 13-14 
LABORATORY EXERCISES — QUEUE MANAGEMENT ....................-.4. 13-17 
Laboratory Exercise 3-1 — QueueS ...... 2.0... cece ee ee eee eens 13-17 
Solutions to Laboratory Exercise 3-1 — Queues ........... 000 cece eee eee eee 13-19 
Laboratory Exercise 3-2 — Batch Queues ........... 0.0. eee eee 13-21 
Solutions to Laboratory Exercise 3-2 — Batch Queues ...............2-00000e 13-22 
Laboratory Exercise 3-3 — Print QueueS.......... 0.00. eee ee eens 13-25 
Solutions to Laboratory Exercise 3-3 — Print Queues ................0. 00 ee eee 13-26 
LABORATORY EXERCISES — PERFORMING BACKUPS AND RESTORES ....... 13-29 
Laboratory exercise: 4-1. Backup: 2:05... seen Mae celeb eu ae eneaw ee how ey 13-29 
Solutions to Laboratory Exercise 4-1 — Backup ............. 0.0 e eee eens 13-30 
Laboratory Exercise 4-2 — Backup to Tape (Optional) ...................005. 13-31 
Solutions to Laboratory Exercise 4-2 — Backup to Tape (Optional).............. 13-32 
LABORATORY EXERCISES — INTRODUCTION TO SYSTEM CUSTOMIZATION .. 13-35 
Laboratory Exercise 5-1 — Customization ......... 0.0.00. ees 13-35 
Solutions to Laboratory Exercise 5-1 — Customization ............... 000000 ee 13-37 
Laboratory Exercise 5-2 — Customization .......... 20... cece eee ee eens 13-39 
Solutions to Laboratory Exercise 5-2 — Customization ............... 00000 eae 13-40 
Laboratory Exercise 5-3 — Customization ........... 0.000 e eee 13-41 
Solutions to Laboratory Exercise 5-3 — Customization ............. 0.0002 eeee 13—42 
LABORATORY EXERCISES — LAYERED PRODUCT INSTALLATION ........... 13-43 
Laboratory Exercise 6-1 — Layered Product Installation...................... 13—43 
Solutions to Laboratory Exercise 6-1 — Layered Product Installation............ 13-44 
Laboratory Exercise 6-2 — Layered Product Installation....................0. 13-45 
Solutions to Laboratory Exercise 6-2 — Layered Product Installation............ 13-46 
LABORATORY EXERCISES — REPORTING ON USER ACTIVITY .............. 13-47 
Laboratory Exercise 7-1 — ACCOUNTING Utility .....................02050. 13-47 
Solutions to Laboratory Exercise 7-1 — ACCOUNTING Utility................. 13-48 


Contents—-xii 


LABORATORY EXERCISES — MAINTAINING SYSTEM SECURITY............. 13-49 


Laboratory Exercise 8-1 — Passwords .............ccccccccceeceueeeeeeeas 13—49 
Solutions to Laboratory Exercise 8-1 — Passwords ................00 ccc eevee 13-50 
Laboratory Exercise 8-2 — Intrusion Records ............. 00.00 c eee eee eee 13-53 
‘Solutions to Laboratory Exercise 8-2 — Intrusion Records .................... 13-54 
Laboratory Exercise 8-3 — Suspect Versus Intrusion Records .................. 13-57 
Solutions to Laboratory Exercise 8-3 — Suspect Versus Intrusion Records ........ 13-58 
Laboratory Exercise 8-4 — Alternate SYSUAF (Optional) .................... 13-61 
Solutions to Laboratory Exercise 8-4 — Alternate SYSUAF (Optional) ........... 13-62 
LABORATORY EXERCISES — MANAGING A NETWORK NODE ............... 13-63 
Laboratory Exercise 9-1 — NCP Utility ..... 20.0.0... 0c eee ees 13-63 
Solutions to Laboratory Exercise 9-1 — NCP Utility ......................05. 13-64 
Laboratory Exercise 9-2 — NCP in a VAXcluster System ................0005- 13-67 
Solutions to Laboratory Exercise 9-2 — NCP in a VAXcluster System............ 13-68 
LABORATORY EXERCISES — SYSTEM MONITORING .................0....4. 13-69 
Laboratory Exercise 10-1 — MONITOR Utility .............0....0.0.......045. 13-69 
Solutions to Laboratory Exercise 10-1 — MONITOR Utility ................... 13-70 
LABORATORY EXERCISES — DEVELOPING COMMAND PROCEDURES. ........ 13-73 
Laboratory Exercise 11-1 — Adding a User .......... 0... ccc cece eee eee 13-73 
Solution to Laboratory Exercise 11-1 — Adding a User ............... 0022000. 13-74 
Laboratory Exercise 11-2 — Generating Accounting Reports................... 13-75 
Solutions to Laboratory Exercise 11-2 — Generating Accounting Reports ......... 13-76 
Laboratory Exercise 11-3 — Writing a Backup Procedure ....................4. 13-77 
Solution to Laboratory Exercise 11-3 — Writing a Backup Procedure ............ 13-78 

14 Test 
QUESTIONS 3 orate eae ed Bente ta aca ens ae Ghe Bae he aes ee Oe BR 14-3 
ANSWERS. 2.05 Sates £00 o,Sacenea tance a tenauaaa sass eee ee ae 14-15 

INDEX 

EXAMPLES 

1-1 SHOW DEVICE/FULL for a Locally Connected Disk......................... 1-13 
1-2. SHOW DEVICE/FULL for a Remote Disk ........... 2.0... 0... ees 1-14 
1-3 SHOW DEVICE/FULL for Dual-Ported HSC Disk....................0200005 1-15 
1-4 SHOW DEVICE/FILES Output oc3c6 da enka sak Sad be HS OE a es eS 1-16 
1-5 SHOW DEVICE Using SYSMAN Output........ 0.0.0... cece eee 1-17 
1-6 Creating a Volume Set from an Existing Volume.................. 0000s 1-19 
1-7 List of Volume Quota File Records........... 0.0.0. cece cee eee eee eae 1-25 
1-8- SET PILE Comman. over esse cat aide BES Say MPO EAS Baa RA RENN BARS 1-31 
2-1 Displaying the Contents of Logical Name Tables ............... 000000 eeeuee 2-7 
2-2 Displaying the Contents of Logical Name Tables ................. 00000 ee eeee 2-8 
2-3 Determining the Value of a Logical Name ............. 00000: cece eee eee 2-10 


Contents-—xiii 


3-9 

3-10 
3-11 
3-12 
3-13 
3-14 
3-15 
3-16 
3-17 
3-18 


5-1 


5-7 


6-7 


6-8 
7-1 
7-2 
7-3 
7-4 


CONCEALED Attribute... 20.0.0. ccc ccc cece cece eee e eee eens 2-12 


Assigning a User to a Logical Default Device ............ 20... 0c eee ee eens 2—12 
Search Listas cael haa ileae ah, er eee Roa Se AS ho ee Sera ee ee 2-13 
Commas in Logical Name Assignments ............. 00. cece cece eee teenies 2-15 
JOB_CONTROL and Print Symbiont Processes............. 00.00 cece ween eee 3-10 
Scheduling Print 00s) o.evn tee eee ye se fate eee dee sea eee te 3-12 
Queue Status Display of Current, Pending, and Holding Jobs.................. 3-17 
Startup Commands in SYSTARTUP_V5.COM .... 0.0.2... 0... eee ee ee eens 3-18 
Modifymeg a Running Queue 35 eS 8 Rak oo ES REAR RE RSE SS 3-24 
SHOW QUEUE — Job and File Separation Page Defaults .................... 3-25 
Moving Jobs from One Queue to Another ............ 2... cece eee eee eee eee 3-32 
Deleting: F Ouse. 3324 saa eek Sek eee baie ae en eae ea a ee oaae a ae 3-33 
Deleting Jobs in QueueS ........... ccc tee e eee e eens 3-33 
JOB_CONTROL and Batch Job Processes ......... 0... 00. eee eee 3-35 
Current and Pending Jobs on a Batch Queue .......... 0.0... cee ee ee ens 3-36 
Stopping Batch Queues ..¢ ota eer che bee FER eee ed we Eee hs Reed ORS 3—41 
Queue Creation Commands on BARNUM ....... 0.0... cc cs 38-45 
Queue Creation Commands on BAILEY ........... 20... 0.00 cece ee ees 3-45 
Queue Creation Commands on All Other Cluster Members.................... 3-45 
SHOW QUEUE Output on Any Cluster Member............ 2... 0.0.02 eee eee 3-45 
Creating and Displaying Cluster-Wide Batch Queues ..............-00.000 008 3-46 
Common Command Procedure for Queue Startup ................--2 ee ee eee 3-47 
Imave Backup or a: Disk... o0et Sou cad Khe Se Bee Ca Ne ee Been aeoas 4-8 
Incremental Backup of a Disk ... 1.0.0... ee eee nea 4-9 
Sample: SYCONPIG-COM: vows bites pied G ee andy Meet aen te aa we Sets 5-8 
Assigning Site-Specific System Logical Names (SYLOGICALS.COM) ............ 5-11 
Saniple- SYLOGICALS COM. 263658094. Soak had HRS ese SES PERS ORG EERO 5-12 
Sample SYPAGSWPFILES.COM ........... 0... ccc ee ee eee ee eee 5-13 
SYSTARTUP_V5.COM Command Procedure ...................0 cee eee eeeee 5-15 
Vsmic a: Captive Account 20s ea ot ee Re eee A Oe MES BOR eS 5-18 
Captive Command Procedure (CAPTIVE.COM)............ 0.00.0 e eee eee eee 5-18 
MODPARAMS. DAD Biles: .4.c35% aac aces aca el dk eb dw DAS ERES RASS 5-24 
SYSMAN PARAMETERS Command ..........0.. 0.0. e eee eee eee ee 5-26 
Product Authorization Key. ......... 0... ccc ccc cc eee ete nett eee e eens 6-14 
VMSLICENSE SOSSION gx. accs-dwa-n peewee MwA GS doh ewe MRE ORS Bee EES 6-15 
Displaying the Existing Global Sections...........0..0 00.000. c eee eee eee 6-19 
Displaying the Available Global Sections and Pages .................000 ee eee 6-20 
Using the VMSINSTAL Command Procedure to Install VAX FORTRAN.......... 6-22 
Using the VMSINSTAL Command Procedure to Make a Copy of a Layered Product 

TG sig BAR SR ad ee ESO PERL SRE A om Fe Oe BE Oe of MO Les ee See 6—25 
Using the VMSINSTAL Command Procedure to Make a Copy of a Layered Product 

Kit (Cony): 243.2 lysate 6 aay Oe ae He Ra BA RR MS ae Reds Fes 6-26 
LICENSE LIST/FULL/HISTORY Output.......... 0.0.0... eee ee ee eee 6-35 
Accounting Record, Pull Pormati<:.¢ 02467. edna G8 BS eee Mies Se eee mene us 7-5 
Accounting Records, Brief Format ............ 0.0... eee eee eee eens 7-10 
Summary Accounting Report for Processor Usage ............. 00.2 eee ee eee 7-11 
Summary Accounting Report, Processor Usage for Batch Users ................ 7-11 


Contents—xiv 


7-5 Accounting Report, Summary Print Information ....................000 000 ee 7-12 


7-6 Accounting Report, Full Print Information ............0. 0.0.0. cc eee eee 7-12 
7-7 Accounting Report, Terminal Information ............0. 0.0.0.0. c cece eee neces 7-13 
7-8 Selecting Accounting Files ......... 0.0... cece eee nent eens 7-14 
8-1 Break-In Suspect Logs in Successfully ......... 0.0... . ec ee ee ees 8-18 
8-2 Break-In Suspect Becomes an Intruder ............ 0.0... ccc ee ee eee eee 8-20 
8-3 UAF Record Field Categories... ..... 0.0... ce cet eee teens 8-28 
8-4 Modifying User Name and Identifier .............. 0... cece eee eee nee 8-33 
9-1. “Additig a: Remote Nodes: 1452s eeeucn ee hubesed hatha Sees iwe e430 eeka see 9-9 
9-2 Removing a Node from the Database............ 0... cee eee ee eens 9-12 
9-3 Changing a Remote Node Entry......... 0.0... ccc nee ee ee eens 9-13 
9-4 Using the TELL Command ............... cece ee ec teen teens 9-15 
9-5 / Setting an: Executor Node: «3 o<.i065004cu bwin Hae ee os EUR hw Se ew ete 9-16 
9-6 Using Access Control for Remote Command Execution ..................02000% 9-17 
10—1. ‘Invoking the MONITOR Utility... ..c000vcSa2.4¢e d00%eh 00022 S28 04 Sand eens 10-5 
10-2 MONITOR SYSTEM Screen Display ........... 0... cc eect eee eee 10-6 
10-3 MONITOR PROCESSES /TOPCPU Screen Display..................00200005 10-7 
10-4 MONITOR Screen Display of the PAGE Class ......... 0... 00. cece ee eee 10-8 
10<3. MONITOR: DH O60 ni3 fi So Ha odes eee Oe POR Aiea oa eied hei Be eas 10-9 
10-6: MONITOR CLUSTER Output. «o.0524-ote4P es ese Sons eae nss echo iass 10-10 
10-7 Using the /NODE Qualifier with MONITOR DISK .....................00005 10-11 
10-8. SHOW MEMORY Output: 2.054646 5.4.664 oh5 60s ese eev Soe LAKE EGS SERS 10-15 
10-9 SHOW SYSTEM/CLUSTER Command ............. 0.0... ee ene 10-17 
10-10 SHOW SYSTEM/NODE Command .............. 0... cece eee ete eens 10-18 
10-11 Output from SHOW PROCESS/CONTINUOUS ........0..0 2.0.0.0. cece eee 10-19 
102 Identifying Lanes: 25-5 satay. cok eacabe ck AER ES ORE ARR ae Ae ee es bee 10-21 
10-13 Showing Known Circuits .... 0.20.0... cc ne eee e eens 10-22 
10-14 Showing Logical Links .... 2... 0.0.0. ee nent nee eens 10-23 
10-15 The Default SHOW CLUSTER Display ............ 20.000. ce nee 10-24 
10-16 SHOW CLUSTER Output (Transition Time) ........... 000.0... cece eee 10—25 
10-17 A Sample SHOW CLUSTER Initialization File ............ 0.0... .00 00. c eee 10-26 
10-18 Display Resulting from SHOW_CLUSTERSINIT............0 00.000... e eee 10—26 
10-419: SUBMON COM: s2:300 602 oda ee we Mods oe ae eRe ae ee MEd ete Ente Res 10-29 
LO=ZO MONITOR COM \6:5..0.4.5 teu Gas, PEAS ONES Oe Oe hed dea oR de aes 10-30 
L022 EMONS UNC OM a4 terns aan ad og Boba a wee a chads @ eeeateann eiwat ard ee & 10-32 
10-22 Command Procedure for MONITOR Recording ............. 00.0. cece eee nee 10-383 
10-23 Procedure to Start Recording on Two Nodes ............ 0.0. cece eee eee ene 10-33 
10-24 Two-Node MONITOR Summary.......... 0... ccc cece ee ene teens 10-33 
11-1 A Formatted Command Procedure............ 0.00 ec eee ee eee ee eee ees 11—6 
11-2 Passing a Parameter to a Command Procedure ............. 000 eee ee eee ees 11-8 
lias. Using Symbol Sibstitntion: scsi iv5.4:02 cae es eae eae ek Baewcch ue hee eed 11-10 
114 Using WRITE SYS$OUTPUT to Display a User Menu ................000000- 11-14 
11-5 Output from the WRITE SYS$OUTPUT Command Fragment.................. 11-14 
11-6 Terminal I/O in Command Procedures ............. 0.0. eee cece et eee eens 11-16 
dias Conditional ISxecntion 5.23% 624s aac Balan des on Bass mem ees SRLS EEE es 11-28 
1iI-8: The GOTO Statement: <2 25 raw vo Saar ee ae es ee eet hee eee 11-29 


Contents—xv 


Lip9: “Using Iteration ..0c soa ee tle Kae SPEER EES ee ww ee oe NEw ecbay 11-30 


11-10 Opening and Closing a File ............. err Te ree ee eee ee eee ee 11-38 
11-11 The READ Command...............0 ccc eee eee eeeee eee eeeeeeeeeeeenes 11-39 
11=12: The WRITE Command :. 4.6 oct eb i REPS Gok ERs CAR ORES ESS BE EESS 11-40 
11-13 Using the CALL Command ............ 0... cece eee ee eee eee eens 11-43 
11-14 Using CALL and GOSUB.......... 2.0.0... cc ene is Me pen eae tet Se ae eA 11—45 
11-15 An Example of Using Error Handling — CHOICES.COM ..................... 11-49 
11-16 Using the SET NOON Command.............. 0... cee eee ee ee eee eens 11-50 
11-17 Handling Pile /O Errors. 2.64 ovis ced het taben eet betes eoes th iaseG4 dws 11-52 
11—18 Comparing Symbol Creation Methods .............. ccc cee eee eee ee eee 11-57 
11-19 Ringing the Bell from Inside a Command Procedure ..................--22-206- 11-59 
12-1 Process Parameters of a Sample Interactive Process .................---0200-- 12-8 
FIGURES 

1-1 Disk and Tape Device Names in a VAXcluster System Using Allocation Classes.... 1-6 
1-2 Adding a Quota Record to a Volume Quota File........... 0.0... eee eee eee 1-24 
2-1 Relationship Between Your Terminal, the Operating System, and Logical Name 

PPAIDIC Siete, 250-8 sisi ay GA deratcc he (ate crates as upd ad Be oe cain ees artes 2 Reed GE ee ah ea a eee Ne ath 2-6 
3-1 File Separation Burst and Flag Pages ............ 0.0. cece ee eee ee eens 3-28 
5-2. File-Separation Trailer Page). iuc02 5 oe 444 eS es 08 OE Re eee d Oe had wea 3-29 
3-3 Job Separation Burst and Flag Pages .......... 0... 0.0 eee ee eee eens 3-30 
5-4. dob Separation. Trailer Pace fa.< ooo cee ve coh hOB WSS RET ED RNa eed 3-31 
f=). -oystem: Accounting Wile cd Goede ew icky aie GN EER RE Ae CO SR ROME EEE 7-9 
8-1 Effect of VMS Startup on System Parameters ............. 0.0. e eee eee eee 8-38 
11-1 How Menu Selection Can be Used to Run Command Procedures................ 11-11 
1A? Wile YO. ahha orcas cae Nils PRCA ARORA Ce eR Ee eee Aa aes 11-36 
11-3 The Global Symbols $SEVERITY and $STATUS .......... 0.0.00. eee eee 11-47 
11-4 Accessing Local and Global Symbol Tables .............. 0.0... cee eee eee 11-55 

TABLES 

1 Course: Conventions: y 4.62.4 65595 53s ho Sa Pee ad oe hos 4 ORE RRR CRORE ES ae Be XX1X 
1-1 Some Common Device Codes ............ 0... cc cece eee ee eee cnet eee 1-5 
1-2 Establishing Quotas on a New Volume Called DISK$DATA.................... 1-23 
1-3 Fields in a Quota File Record......... 0.0... ccc ec ee te ee eee eee ees 1-23 
1-4 Displaying the Contents of a Volume Quota File .........0 0.0.0.0... eee eee eee 1-26 
1-5 Managing Individual Records in the Volume Quota File ...................05. 1—26 
1-6 Establishing Quotas on an Existing Volume Called DISK$USER ............... | 1-27 
1-7 Some Qualifiers for the SET FILE Command ..............0 0.00. e eee eee 1-30 
2-1 Process and Job Logical Names Defined by the System ..................0005. 2-16 
2-2 Some of the System Logical Names Defined by the System.................... 2-17 
3~1 Initializing and Starting Queues ....... 2.0.0.0... cee ee nee 3-14 
3-2 Creating and Using Print Execution Queues ............... 02. eee eee eee eee 3-15 
3-3 Creating and Using Generic Print Queues............ 0.0.0 cee eee eee eee 3-16 
3-4 SHOW QUEUE Qualifiers for Displaying Types of Queues .................... 3-20 
3-5 SHOW QUEUE Qualifiers for Displaying the Amount of Queue Information ...... 3-20 


Contents—xvi 


3-6 
3-7 
3-8 
3-9 
3-10 
3-11 
3-12 
3-13 
3-14 
3-15 


ae 


5-2 
5-3 
5-4 
5-5 
5-6 
6-1 


6-3 
6-4 
6-5 
7-1 
7-2 
7-3 
7-4 
8-1 
8-2 
8-3 
8-4 
8-5 


Oueiie Stans Codes. 2 c's waa twce yp ae a Ses gts ee acca A ee See wha add 3-21 


POD tAMIS COMES: + beac wae ba Fieve al hae dd eS Ga OSE Re Os AW et Ee ORES oe 3-22 
Commands to Modify Queue Attributes at Certain Times .................005. 3-23 
Job Separation Page Options for the /SEPARATE Qualifier..................4. 3-27 
File Separation Page Options for the /DEFAULT Qualifier .................... 3-27 
Positioning a Print dO" +3 3.29 see eh hatte ase Lea ones FO SE oe ee woe 3-34 
Ahipning Printer Papers ..4.%. 4 5-e Poe ee tea dened eee ae VAG Stare 3-34 
Batch Queue Names and Parameter Values..........0 0.0.0. c eee eee eee 3-38 
Qualifiers to INITIALIZE/QUEUE for Batch Queues...............2000 000 3-39 
Summary of Queue-Related DCL Commands................ 0.0.0 3-48 
Save Operation Quick Reference Table ............ 0... cece ee eee eens 4-20 
Restore Operation Quick Reference Table ............... 00 ccc eee eee eee eee 4-22 
Copy Operation Quick Reference Table ........ 20.0.0... ce cece eee eee eee 4—24 
Compare Operation Quick Reference Table ............ 2.0... cee cece eee eee 4-24 
List Operation Quick Reference Table .............0 0... cece ee eee eee 4—25 
Assigning System Logical Names......... 0.0.0.0 cc ec eee ee eee eens 5-10 
Some Standard Logical Names to Define in SYLOGICALS.COM................ 5-10 
Typical Login Command Procedures (DCL) ............. 0... eee eens 5-17 
System: Miles: s.c.ouen panera haawe ete hawt eeu ed igtie bande teed awe 5-19 
PBUTOGEN: PHASES oe ja ichsety dt cain esther dvk ake Saree ee Re hs tee eh AE te gna 5-23 
SYSMAN PARAMETERS Subcommands............ 0... cece c eee ees 5-25 
Values for an Activity License LURT ..........0.. 0.0.0 eee 6-11 
LICENSE Subcommands::.:4 ss $0:4.440.0% 44640 bowen eel ila be bs eas ee ese es 6-13 
AUTHORIZE Qualifiers for Quota Fields..........0..0.. 0.000.000 02. cece 6-18 
Commonly Set SYSGEN Parameters ...........0. 000 ee eee eee eens 6-21 
VMSINSEALODUONS: suii4 credo oc ooAtawis Bose maw dia Se at are oo ee Bie Sete ants 6-27 
Recording Accounting Information .............0. 00. ccc cee tee eee eens 7-6 
Some Qualifiers Used to Specify Content of Accounting Report ................. 7-14 
Qualifiers Affecting Output Format of Accounting Report ..................... 7-15 
Steps for Creating an Accounting Report..........0.0 0... 0c cece eee ee eens 7-16 
Setting Erase-On-Delete for a File or Volume ............ 0.00000 ce eee eee 8-10 
Defining User Passwords 2s6.2.0543:4 6.020 Sew Ob Ra oA eS oe Ee Ser wee RE 8—11 
Defining a System Password for a Terminal ............0 0.000 cc eee ce eee ees 8-12 
Using Passwords ig o.50 ceca oo 5G ace eehed Fas Wee ee eae Ree aS ok 8-13 
Establishing Ownership and Protection of Terminals and Other Nonshareable 

DOVACER Sheth sei CH Moe ibs 4 ate ae ae Nas we BY is Se eb ae eae 8—15 
SYSGEN Parameters for Break-In Detection............ 0.00000 cece eee eee 8-17 
ACL- and UIC-Based Protection ...... 2.0.0... ccc eee eee eee eee 8-23 
Dividing Users mite Groups 2:4 6 kk hea tea ask ee Ae ee AS G 8-25 
Interaction Between Processes in Same Group ...........0 0.00 c eee eee eens 8-26 
Opi ACCS MOOS 6. os co ar lh Rew OM atic oe BAU doors gs detaig ae data ee Oe Ra, 8 8-30 
AUTHORIZE Qualifiers for Access Fields .........0 0.00... cc cece eee ee eee 8-30 
Login Flag Parameters Related to Security ...........0 0... ccc cece ee eee 8-31 
AUTHORIZE Qualifiers for Security Fields ......... 0.0.0... cece eee eee 8-32 
AUTHORIZE Qualifiers for Privilege Fields ............ 00... eee cece eee 8-34 
WMS Privile pes 2x scram tere hw fad ew see ouknd Re a Re a a ed eG 8-35 


Contents-xvii 


8-16 Using SYSBOOT During Conversational Startup ................... ae tea YS 8-37 


9~1 Commands that Maintain the Configuration Databases ..................000. 9-7 
9-2 Required DECnet Privileges ....... 2.0... 0. ccc eee cece eee ees 9-8 
10-1 MONITOR PROCESSES Class Qualifiers .............0 0.0.0.0 0 eee ee eee 10-7 
10-2 MONITOR Class Names .......... 0... ccc ee ence eee eee ee eens 10-14 
10-3 Effect of Memory Sizes on Performance............ 0.0... cee ec teen 10-16 
LO—4> -Line Teen Uh cation so, xs Shs ees ek eR ee ee SES SE OG DEER RR es boas 10-21 
10-5 Circuit Identification ...... 0.0.0 ec ec ee ee eee eee eee eens 10-22 
10-6 Basic SHOW CLUSTER Commands .............. 0.0.0 ee eee 10-27 
10-7 System, Process, and Device Monitoring .......... 0.2... 0c cece ee eee een 10-28 
11-1 Symbol Substitution Techniques ..........0... 00 ccc cece eee ence ees 11-9 
11-2 Logical Names Used with /O.. 2... 0... ce nee e ene 11-12 
11-3 Examples of String Operations .......0.. 0.0.00. ccc eee eee eee ees 11—20 
li—4: Arithmetic Operators... 6064 os sean ohn Sa dead wba $a edd eae eeen aad 11-21 
11-5: Fractional Calewiations: iii. cicccs anaes a he Rbe Ge Rh Oe Heh Gah bee ee 11-21 
11-6 String Comparison Operators .......... 0.0. ccc ce cece ee eee ee ee ees 11-22 
11-7 Example Character String Comparisons ........... 0.0.0.0 c cee cece eee eee 11-23 
11-8 Arithmetic Comparison Operators ........... 00.0. cece eee ee ee eee eee eae 11-24 
11-9 Example Arithmetic Comparisons ............ 0.0.0. eee tee eee 11-25 
11—10 Commands Used to Control Execution Flow .............. 0.00 c cece ee eee 11-26 
11-11 Qualifiers for the OPEN Command ............. 0.00.00. 11-37 
11-12 Qualifiers for the CLOSE Command .............. 0.00... ccc ee eens 11-38 
11-13 Some Qualifiers for the READ Command ................ 0.0.0.0 eee e ee eee 11-39 
11-14 Some Qualifiers for the WRITE Command.....................000 eee ee eee 11—40 
11=15 Use of the-ON: Command ¢ i22.04-.44'setwkiewad bees s fae ei edna’ ee Se os 11-48 


Contents—xviii 


About This Course 


INTRODUCTION 


The VMS System and Network Management II course is designed to give system managers of 
VMS systems and networks additional information about how to manage a computer running 


the VMS operating system. 


This student workbook is divided into a number of chapters, each designed to cover a 
well-organized topic, or group of topics. Most chapters include figures, tables, and examples 
to enable students to better understand the material. Two separate exercise chapters (one for 
written exercises and one for laboratory exercises) can be found at the back of this workbook 
to allow students to test their VMS system and network management skills. 


This section (“About This Course”) describes the contents of the course and suggests ways to 
use its materials most effectively. The following topics are discussed here: 


Course Overview 
Intended Audience 
Prerequisites 
Course Goals 
Course Nongoals 
Course Organization 
Course Map 
Resources 


Course Conventions 
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COURSE OVERVIEW 


This task-oriented course continues the system management training presented in VMS System 
and Network Management I. \t prepares the participant to perform and automate daily system 
management tasks in an existing VMS or VAXcluster system and network environment. This 
course provides students with the information and guided practice they need to perform the 
tasks required of system managers in an operational environment, such as maintaining disks 
and queues, performing full and incremental backups, and installing layered products. Coverage 
of the use of command procedures to automate repetitive tasks is included. The course also 
introduces the strategies and methods used to secure a VMS environment as well as the tools 
for monitoring system activity. 


Each chapter builds on the topics covered in the VMS System and Network Management !| 
course and also on the individual student’s system and network management experience. 


The VMS System and Network Management II course covers: 
¢ Managing Disks 

¢ Using Logical Name Tables 

* Queue Management 

« Performing Backups and Restores 

¢ Introduction to System Customization 
¢ Layered Product Installation 

¢ Reporting on User Activity 

¢ Maintaining System Security 

* System Monitoring 

¢« Managing a Network Node 


* Developing Command Procedures 
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INTENDED AUDIENCE 


This course is for system managers who require basic system, cluster, and network management 
skills. These system managers have taken VMS System and Network Management | or have 

similar knowledge and experience, and are ready to learn how to perform the full complement 
of daily system management and operations tasks. 


The course assumes that the students are to manage systems that have already been installed 
and customized, and that on returning to their sites, each student has access to at least one 
experienced system manager who can perform system customization and provide support. 


PREREQUISITES 


Before taking this course, the system manager should be able to: 
« Perform basic user tasks on a VMS system, including: 
-— Logging in and out 
— Sending mail messages to other users 
— Editing a text file with a text editor 
« Manage system users, which requires: 
— Maintaining the user authorization file and volume quota files 
— Creating user file directories (UFDs) 
— Controlling user processes 
« Manage system resources, which requires: 
— Mounting and dismounting disk and tape volumes 
— Setting device characteristics 
— Starting and stopping print and batch queues 
— Performing full backup and restore on a disk volume 


— Starting up and shutting down a system using the default startup procedure 


These prerequisites can be satisfied by taking the VMS System and Network Management | 
course or obtained through experience operating or managing a VMS system. 
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COURSE GOALS 


To perform daily system management, the system manager should be able to: 


Manage queues, disks and tapes, and terminals 

Perform all types of backup and restore operations 
Describe the functions of the system startup and login files 
Use AUTOGEN and SYSMAN to set system parameters 
Install VMS layered products and updates 

Use Accounting to collect process information 

Describe general system security mechanisms 

Monitor the system for certain behavioral problems 
Describe general tasks for managing a network node 


Write and use command procedures to automate system management tasks 


NONGOALS 


VMS System and Network Management II! does not cover the following topics: 


Basic use of a VMS system (covered in VMS System and Network Management I) 
System installation, including VMS operating system installation, adding nodes to a 
VAXcluster system, or adding nodes to a network (covered in VMS System and Network 
Management Ih 


System customization, including customizing boot procedures (covered in VMS System 
and Network Management III 


System performance management and tuning (introduced in VMS System and Network 
Management Ill and taught in VMS System Performance Management) 


Details of system security features (taught in VMS System Security Features) 


System troubleshooting 


xxiv About This Course 


COURSE ORGANIZATION 


This course is organized into a series of chapters. Each chapter has its own learning objectives 
and covers a single topic or group of closely related topics. Each chapter consists of: 


An introduction, which describes the purpose of the chapter, provides motivation for 
mastering its objectives, and outlines its contents. 


One or more objectives, which identify the skills taught in the chapter. Objectives are 
designed to focus your study efforts on a selected number of skills. 


The chapter text, which consists of: 
— Descriptive text organized in a list format 


— Illustrations, which clarify the relationships among various elements of a VMS system, 
or summarize steps of a particular process or command 


— Examples containing sample listings from actual interactive sessions on a VMS system 


A chapter summary that reviews important concepts and skills taught in the chapter 


Written and laboratory exercises are also provided with this course. These exercises help 
students to review and practice the skills learned during the lecture session. 
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RESOURCES 


The books and manuals listed here should be available for your reference in the classroom or 
in the laboratory. 


Guide to DECnet-VAX Networking 

Guide to Maintaining a VMS System 

Guide to Setting Up a VMS System 

Guide to Using VMS 

Guide to Using VMS Command Procedures 
Guide to VMS File Applications 

Guide to VMS Files and Devices 

Guide to VMS Performance Management 
Guide to VMS System Security 

Introduction to VMS System Management 
VAX Systems and DECsystems Systems and Options Catalog 
VMS Accounting Utility Manual 

VMS Analyze/Disk_Structure Utility Manual 
VMS Audit Analysis Utility Manual 

VMS Authorize Utility Manual 

VMS Backup Utility Manual 

VMS DCL Concepts Manual 

VMS DCL Dictionary 

VMS Install Utility Manual 

VMS Guide to Disk and Magnetic Tape Operations 
VMS Installation and Operations guides 


VMS License Management Utility Manual 
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¢ VMS Monitor Utility Manual 

‘ VMS Network Control pogian Manual 
¢ VMS Networking Manual 

« VMS Release Notes 

¢ VMS Show Cluster Utility Manual 

* VMS System Generation Utility Manual 
¢« VMS System Manager's Manual 

« VMS System Messages and Recovery Procedures Reference Manual 
« VMS SYSMAN Utility Manual 

* VMS User’s Manual 

¢ VMS VAXcluster Manual 
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COURSE CONVENTIONS 


Table 1 describes the conventions used in the listings and command tables of the student 


workbook. 


Table 1 Course Conventions 


Convention 
CTRL/X 


UPPERCASE 


lowercase 


Ellipsis 
Choad 


Square 
Brackets 


([]) 


Quotation Marks 
and Apostrophes 


Meaning 
Press and hold the key labeled CTRL while you press another key (X). 
Many control keys have special meanings. 


In commands, uppercase characters indicate words you type exactly as 
they appear. For example, you would type the following commands as 
they appear: 


$ DIRECTORY 
S TYPE LOGIN.COM 


Lowercase characters represent elements that you must replace according 
to the description in the text. For example, you must follow certain rules 
when you replace "“file-spec” in the following example: 


$ TYPE file-spec 


Horizontal ellipses indicate that you can enter additional parameters, 
values, or information. For example, you can enter any number of file 
specifications in the following example: 


$ TYPE file-spec, ... 


Vertical series of periods or ellipses mean that not all of the data that the 
system would display in response to the particular command is shown, or 
that not all the data a user would enter is shown. 


$ TYPE MYFILE. DAT 


$ 


Square brackets indicate that the enclosed item is optional. (Square 
brackets are not optional, however, in the syntax of some file 
specifications.) For example, the logical name is optional in the following 
command: 


$ MOUNT/FOREIGN $TAPE1 
Braces indicate that you must select from the included items. 


The term quotation marks refers to double quotation marks ("). The term 
apostrophe refers to a single quotation mark (’). 


About This Course xxix 


Managing Disks 


INTRODUCTION 


This chapter presents the basic concepts of disk management. Among the topics covered are: 
* The conventions used for VMS device names 

¢ The conventions used for VMS device names in a VAXcluster system 

¢ How to modify characteristics of disk files 


¢ How to use disk quotas to control disk space allocation 
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OBJECTIVES 


To describe the tasks and responsibilities for maintaining disks, a system and network manager 


should be able to: 


Identify devices by name in a VAXcluster system 


Mount devices in a VAXcluster system 


Use VMS SHOW command to obtain information on system disk devices 


Create a volume set 
Modify several important file characteristics 


Use disk quotas to control the allocation of disk space to users 


RESOURCES 


VMS DCL Dictionary 
VMS System Manager’s Manual 
Guide to Setting Up a VMS System 


Guide to Maintaining a VMS System 


TOPICS 


Review of VMS device names 

Device names in a VAXcluster system 

Using SHOW DEVICE to obtain information about disk volumes 
Creating volume sets 

Setting file characteristics 


Using disk quotas to manage disk space usage 
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REVIEW OF VMS DEVICE NAMES 


Every device has a unique name in the format: ddcu 
dd A two-letter device code 


c A one-letter code that specifies the hardware controller for the device. 
(Controllers provide the interface between the bus and the device, or between 
two buses.) 

u The device unit number 


The device code specifies the device type. 
The hardware controller number: 
¢ Identifies the device controller 
¢ Is represented by a letter from A to Z 
« Is assigned by the system 
The unit number: 
¢ Indicates the position of the device on the controller 
« Can be changed by: 
— Setting a button or switch on the device 


— Installing a unit plug on the device 


Table 1—1 lists some common two-letter device codes. 


Table 1-1 Some Common Device Codes 


Code Device 

CS Console storage device 

DU RA80 or RA81 disk drive 

MU TK70 tape drive 

LT Terminal connected by means of a terminal server 
For example: 


« CSA1 = Console Storage, Controller A, Device 1 


¢ LTA251 = Local Area Transport, Controller A, Device 251 
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DEVICE NAMES IN A VAXcluster SYSTEM 


Figure 1-1 shows a sample cluster with allocation classes assigned to nodes. It also shows 
the device name of each disk and tape drive. 


Figure 1-1 Disk and Tape Device Names in a VAXcluster System Using Allocation 
Classes 


DISK ALLOCATION CLASS=2 a 
| = $2$DUA0 | 
LIONS$DUAO: | A B | 


a BEAR Sas HORSE 
LION TIGER | | 


Ethernet 








fis, Ge ent 


| 
i 
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MSCP Server 


The mass storage control protocol (MSCP) server allows disks connected locally to a VAX 
processor or to an intelligent, MSCP compliant controller to be shared cluster-wide. 


¢ These disks include: 
— Disks local to Cl members 
— Disks on boot servers, and disk servers anywhere in the cluster 
— Disks on disk servers anywhere in the cluster, including satellites 


— HSC disks in mixed-interconnect clusters (when the MSCP server is running on one of 
the Cl nodes) 


— Integrated storage element (ISE) disks connected to a DSS! (Digital standard storage 
interconnect) in a mixed-interconnect cluster 


¢ The MSCP server decodes and services MSCP |I/O requests sent by the disk class driver 
on remote cluster nodes. 


— Once a device is MSCP served, any processor in the cluster can mount the device and 
access it as if it were a local device. 


Tape MSCP Server 
The tape MSCP server peforms a similar function for tape drives. 


¢ Once a tape device is MSCP served, any processor in the cluster can mount and access it 
as if it were a local device. 


* Like a local tape drive, an MSCP served tape drive can be used by only one process at a 
time. 
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Device Name Formats 
Two formats are used in naming devices: 
- node$device 
— Used for devices that are directly connected to only one node. 
— Zero is the default value for the ALLOCLASS SYSGEN parameter, forcing this format. 
- $allocation-class$device 


— Allocation class is a parameter set on a node that serves disks (an HSC or ISE 
controller or a VAX node running the MSCP server). 


— Zero is the default. 


— Setting the ALLOCLASS parameter to non-zero (1-255) enables this format for device 
names. 


— Used for dual-pathed (including dual-ported and dual-hosted) devices, to provide a 
single name for the device. 


— For any disk or tape device, all nodes that serve it to the cluster must have the same 
allocation class. 


¢ No two devices in a cluster can have the same name. 
For example, if both BARNUM and BAILEY have allocation class 1: 


— You may not connect a drive named DUAO to each node because there would then be 
two devices named $1$DUAO0. 


— To avoid this problem, change the unit number of one of the drives. 
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When a device is on a local node: 
¢ You can use its traditional name (for example, TXA2). 
* You can prefix its name with the node name (for example, BARNUM$TXA2). 


« Each disk must have a unique volume label. 


Use node$device to refer to devices on other nodes when specifying: 
¢ A terminal on another node to OPCOM 


¢ A printer on another node to the job controller 
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MOUNTING VOLUMES 


To mount disk volumes in a common-environment VAXcluster system for the highest availability: 
« Make local devices available cluster-wide through the MSCP server. 

* Mount HSC based disks on all Cl members using the MOUNT/SYSTEM command. 

- Mount DSSI based ISEs on all DSS] members using the MOUNT/SYSTEM command. 

« Mount MSCP served HSC, DSSI, and local disks on any or all nodes. 


— The command MOUNT/CLUSTER mounts a disk volume on all nodes currently in the 
Cluster. 


— Anode that joins the cluster later must explicitly mount the volume. 

* So that all volumes remain mounted cluster-wide, the startup command procedure should: 
— Mount all local MSCP served disks with the MOUNT/CLUSTER command 
— Mount all remote disks with the MOUNT or MOUNT/CLUSTER command 


Proper Dismount of Disks on Shutdown 

Building a VAXcluster system should include setting up SYS6MANAGER:SYSHUTDWN.COM. 
When you shut down a system: 

¢« DISMOUNT/CLUSTER each MSCP served disk on the system that is not dual-ported. 


— Disks that are not dismounted undergo mount verification on other systems that have 
them mounted. 


— All processes with outstanding I/O to these disks hang. 


— If mount verification times out, the other systems must dismount and remount the 
disks. 


¢  Dismount disks in the site-specific shutdown procedure 
SYS$MANAGER:SYSHUTDWN.COM 


— For example, on HORSE: 


$ DISMOUNT/CLUSTER/ABORT $2SDUAO0: 


— /ABORT forces a disk to be dismounted even if it has open user files. This does not 
work if the open files are paging or swapping files, or if the disk is a system disk. 
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Rebuilding Incorrectly Dismounted Disks 


Free space and storage allocation inconsistencies caused by incorrect dismounting of the 
system disk (for example, if there is a system failure) are fixed by rebuilding the disk. 


Rebuilding takes place automatically unless you use the MOUNT/NOREBUILD command 
to mount the disk. 


You should use MOUNT/NOREBUILD in the startup command procedure to mount each 
disk in a VAXcluster system. 


— Otherwise, processes using the disk hang until the rebuild completes. 


If the system disk is rebuilt at startup time, and the system disk is also being served by the 
MSCP server, the cluster can hang indefinitely. 


— To prevent this situation, on any system that serves a system disk or that boots 
from a served system disk you must use AUTOGEN to set the SYSGEN parameter 
ACP_REBLDSYSD to 0. 

— ACP_REBLDSYSD defaults to 0 for satellites; you must set it for boot servers. 


Rebuild disks at a more convenient time (such as in a batch job at an off-hour). 


$ SET VOLUME/REBUILD SYSSSYSDEVICE 
$ SET VOLUME/REBUILD $1SDUA1: 


— _ lf the disk does not need to be rebuilt, this command has no effect. 


There is no risk to data integrity by not rebuilding a disk at startup time. The worst 
consequence is that some free space is not available until the disk is rebuilt. 
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USING SHOW DEVICE TO OBTAIN INFORMATION 
ABOUT DISK VOLUMES | 


* SHOW DEVICE 
— Lists devices on the system 
« SHOW DEVICE/FULL 
— Shows the complete status of a device 
— Useful for determining the configuration of disks in a cluster 
« SHOW DEVICE/FILES 
— Lists the files that are currently open 
— This command lists files opened only on this node 
* SHOW DEVICE D 


— To see a list of only disk devices: 
$ SHOW DEVICE D 


Device Device Error Volume Free Trans Mnt 
Name Status Count Label Blocks Count Cnt 
LIONSDUAO: Mounted 0 (remote mount) 1 
$1SDUAO: (CLOWN) Mounted OQ THREERING 195039 417 7 
S1SDUA1: (HIWIRE) Mounted Q TIGHTROPE 223851 1 i) 
S1SDUA2: (BARNUM) Mounted 0 FLYING 261060 Ab 7 
SISDUA3: (BAILEY) Mounted OQ TRAPEZE 174615 6 7 
$2SDUAO0: (BEAR) Mounted Q ELEPHANT 195039 417 7 
$2SDUA1: (BEAR) Mounted Q BALLERINA 223851 1 7 
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Example 1-1 SHOW DEVICE/FULL for a Locally Connected Disk 


$ SHOW DEVICE/FULL $1SDUA2 


Disk $1$DUA2: (BARNUM), device type RA81,@ is online, mounted, 


@file-oriented device, 


shareable, served to cluster via MSCP Server, 
Error count 0@ 

Owner process weds 

Owner process ID 00000000 


Reference count 1 


Total blocks 891072@ 
Total cylinders 1248 
Allocation class 1 
Volume label "EF LYING" 
Cluster size 3 
Free blocks 30699 
Extend quantity 5 
Mount status System 
Extent cache size 64 
File ID cache size 64 
Quota cache size 30 


Volume status: 
through caching enabled. 


subject to mount verification, 


error logging is enabled. 


Operations completed 5989 
Owner UIC [1,1]8 
Dev Prot S:RWED, O:RWED, G:RWED, W: RWED@ 
Default buffer size 512 
Sectors per track 51 
Tracks per cylinder 8 
Relative volume number 0 
Transaction count 93 
Maximum files allowed 222768 
Mount count 7 


Cache name " $1SDUA0:XQPCACHE" 
Maximum blocks in extent cache 2088 
Blocks currently in extent cache 0 
Maximum buffers in FCP cache 129 


file high-water marking, 


Volume is also mounted on RNGLNG, BAILEY, LION, HORSE, BEAR, TIGER.@ 


This example answers questions including the following: 


What type of disk is it? 


Is it mounted on the local system? 


How big is it? (in 512-byte blocks) 


How many blocks are free? 


eo 60 86 8 8 8 


fallecete 3 bloc less 
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Is it mounted on any other system in the cluster? 


What is the owner UIC and volume protection? 


Has it generated any hardware errors since the system was started up? 
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write- 


Example 1-2 SHOW DEVICE/FULL for a Remote Disk 


$ SHOW DEVICE/FULL $1$DUA2 


Disk $1$DUA2: (BARNUM), 
device, shareable, 


device type RA81, 


Error count 0 
Owner process wu 
Owner process ID 00000000 
Reference count 1 
Total blocks 891072 
Total cylinders 1248 
Host name "BARNUM"@ 
Allocation class 1 
Volume label "FLYING" 
Cluster size 3 
Free blocks 8069 
Extend quantity 5 
Mount status System 
Extent cache size 64 
File ID cache size 64 
Quota cache size 30 


Volume status: 
through caching enabled. 


subject to mount verification, 


is online, mounted, file-oriented 


available to cluster, error logging is enabled. 


Operations completed 5989 
Owner UIC [1,1] 
Dev Prot S:RWED, 0: RWED,G:RWED, W: RWED 
Default buffer size 512 
Sectors per track 51 


Tracks per cylinder 8 
VAX 8810, yes@ 


Host type, available 

Relative volume number 0 
Transaction count 93 
Maximum files allowed 222768 
Mount count 7 


Cache name " $1SDUA2 :XQPCACHE" 


Maximum blocks in extent cache 2088 

Blocks currently in extent cache 0 

Maximum buffers in FCP cache 129 
file high-water marking, write- 


Volume is also mounted on BARNUM, RNGLNG, LION, HORSE, BEAR, TIGER. 


Additional information you might want to kn 


ow about a remote disk: 


@ Which cluster node is the disk connected to? 


@ What type of node is it connected to? 
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Example 1-3 SHOW DEVICE/FULL for Dual-Ported HSC Disk 


$ SHOW DEVICE/FULL $1SDUA1 


Disk $1$DUA1: (HIWIRE), device type RA82, is online, mounted, file-oriented 
device, shareable, available to cluster, error logging is enabled. 


Error count 2 Operations completed 2352587 
Owner process mM Owner UIC [1,1] 
Owner process ID 00000000 Dev Prot S:RWED, O:RWED, G: RWED, W: RWED 
Reference count 76 Default buffer size 512 
Total blocks 1216665 Sectors per track 51 
Total cylinders 1248 Tracks per cylinder 14 
Host name "HIWIRE"@ Host type, available HSc50, yesO 
Alternate host name "CLOWN"@ Host type, available HSC70, yesO 
Allocation class 1 
Volume label "TIGHTROPE" Relative volume number 0 
Cluster size 1 Transaction count 223 
Free blocks 121857 Maximum files allowed 222768 
Extend quantity 5 Mount count 7 
Mount status System Cache name " $1SDUA1 :XQPCACHE" 
Extent cache size 64 Maximum blocks in extent cache 806 
File ID cache size 64 Blocks currently in extent cache 70 
Quota cache size 0 Maximum buffers in FCP cache 350 
Volume status: subject to mount verification, file high-water marking, write- 


through caching enabled. 
Volume is also mounted on BAILEY, LION, HORSE, RNGLNG, BEAR, TIGER. 


information about a disk connected between two HSC nodes: 
@ What controllers is it connected to? 


@ What types of controllers is it connected to? 
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SHOW DEVICE/FILES 


Shows which files on a particular device are open by processes on the local system. 


Example 1-4 SHOW DEVICE/FILES Output 


$ SHOW DEVICE/FILE $1$DUA1: 


Files accessed on device 


Process name PID 
00000000 
00000000 
TOM 20202580 
Bette 2020267C 
Ed Bernstein 2020233A 
Ed Bernstein 2020233A 
Mike Beeler 2020275B 
Mike Beeler 2020275B 
Mike Beeler 2020275B 


_S$1SDUA1: on 9-MAY-1989 11:47:44.50 


File name 

[000000] INDEXF.SYS;1 
{000000]QU0OTA.SYS;1 
[JAGGER.MAIL]MAIL.MAI;1 

[FINNERN. OLTP]OBJECTIVES.TJL;1 
[BERNSTEIN] MYEVEPLUS.TPUSSECTION; 44 
{BERNSTEIN.CLUSTER] LL1.TJL;1 
{BEELER.CLUSTER.LL] TEST_IT.DAT;1 
[BEELER.CLUSTER.LL]D.COM;1 
[BEELER.CLUSTER.LL]T.LIS;1 


Reasons you might want this information: 


¢« You cannot dismount a disk volume because it has open files on it. 


— The output shows you which files are open and by which process. 


e A user cannot open a shared data file because another user already has it open. 


— Look for that file in the output and note which user’s process has it open. 
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You can also use SHOW DEVICE using SYSMAN to list all of the open files in a cluster. 
Example 1-5 SHOW DEVICE Using SYSMAN Output 


$ SET DEFAULT SYSSSYSTEM 
S$ SET PROCESS/PRIVILEGE=SYSPRV 
S RUN SYSMAN 
SYSMAN> SET ENVIRONMENT/CLUSTER 
%SYSMAN-I-ENV, current command environment: 
Clusterwide on local cluster 
Username MATTHEWS will be used on nonlocal nodes 


SYSMAN> DO SHOW DEVICE/FILES $2SDUAO0 
%SYSMAN-I-OUTPUT, command execution on node BARNUM 


Files accessed on device $2SDUA0O: (BEAR) on 4-SEP-1991 17:38:10.89 


Process name PID File name 
00000000 [000000] INDEXF.SYS;1 
%SYSMAN-I-OUTPUT, command execution on node RNGLNG 


Files accessed on device S$2SDUA0: (BEAR) on 4-SEP-1991 17:37:37.71 


Process name PID File name 
00000000 [000000] INDEXF.SYS;1 
Livvy 0 23200095 [BUNNELL] DECWSSM. LOG; 40 


00000000 [MANDRA.SYSEXE] PAGEFILE1.SYS;1 
SSYSMAN-I-OUTPUT, command execution on node BEAR 


Files accessed on device $2SDUA0: (BEAR) on 4-SEP-1991 17:37:58.38 


Process name PID File name 
00000000 [000000] INDEXF.SYS;1 
DECWSSESSION 23600058 [ROUNDS]DECWSSM.LOG; 222 
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CREATING VOLUME SETS 


lf the files or user directories become too large to fit on any one volume, you can create a 
volume set. 


« Two or more disk volumes 


¢ Bound together with the MOUNT/BIND command 


The VMS operating system: 
¢ Treats a volume set as one large volume 
¢ Stores files on any volume in the set that has free space 


« Attempts to use space evenly over all volumes in a set 


Use the following procedure to create a disk volume set: 
1. Allocate the necessary devices, and physically load the volumes on the devices. 
2. Initialize each new volume in the set. 


3. Use the MOUNT/BIND command to create the volume set. For example: 


$ MOUNT/BIND=MASTER SET DB1:,DB2: PAYVOL1,PAYVOL2 


Example 1-6 illustrates how to create a public volume set (USER_SET) starting with an existing 
volume (USER1) as the root volume. 
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Example 1-6 illustrates how to create a volume set from an existing volume. 


Example 1-6 Creating a Volume Set from an Existing Volume 


@ $ ALLOCATE DRA2 DEV1 
SDCL-I-ALLOC, _DRA2: allocated 
S$ ALLOCATE DRA3 DEV2 
SDCL-I-ALLOC, _DRA3: allocated 

Qs INITIALIZE/SYSTEM DEV2 USER2 

Os MOUNT /SYSTEM/BIND=USER_SET DEV1,DEV2 USER1,USER2 
%SMOUNT~I-MOUNTED, USER1 mounted on _DRA2: 
SMOUNT-I-MOUNTED, USER2 mounted on _DRA3: 


@ s SHOW LOGICAL/SYSTEM D* 
(LNMSSYSTEM TABLE) 


"DBGSINPUT" = "SYSSINPUT:" 
"DBGSOUTPUT" = "SYSSOUTPUT:" 
"DDPSDIS" = "SYSSMANAGER:DDP.DIS" 
"DISKSUSER1" = "DRA2:" 

"DISKSUSER2" = "DRA3:" 
"DISKSUSER_SET" = "DRA2:" 
"DISKSVAXVMSRLO52" = "DUAO:" 
"DTRSLIBRARY" = "SYSSSYSROOT: [DTR]" 


$ 
@ s COPY WORK1: [BROWN] EXAMP5 .COM 
To: DISK$USER_SET: [SMITH] EXAMP5 .COM 


$ DIRECTORY DISKSUSER_SET: [SMITH] 
Directory DISKSUSER_SET: [SMITH] 
EXAMP5.COM;1 


Total of 1 file. 
@ s DISMOUNT DEV1 
$ SHOW LOGICAL/SYSTEM D* 


(LNMSSYSTEM_ TABLE) 


"DBGSINPUT" = "SYSSINPUT:" 
"DBGSOUTPUT" = "SYSSOUTPUT:" 

7) "DDPSDIS" = "SYSSMANAGER:DDP.DIS" 
"DISKSVAXVMSRLO52" = "DUAO:" 
"DTRSLIBRARY" = "SYSSSYSROOT: [DTR]" 
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Notes on Example 1-6: 


These commands allocate two disk devices for the volumes USER1 and USER2, and give 
them the logical names DEV1 and DEV2 respectively. After allocating the devices, the user 
loads the volumes (USER1 and USER2) into their respective drives. (USER1 is an existing 
volume; USER2 is a new volume.) 


USER2, since it is a new volume, is initialized to delete old files and create a Files—11 
structure. The /SYSTEM qualifier sets the owner UIC to [1,1] and the protection code to . 
(S:RWED,O:RWED,G:RWED,W:RWED). 


The MOUNT command string binds the volumes into the disk volume set, USER_SET. The 
SYSTEM qualifier makes the set public. You must have SYSNAM privilege to use it. The 
root volume (USER1) contains the directory structure for the entire volume set. 


The user did not include a logical name for the volume set in the MOUNT command. 
Therefore, the system creates the logical names DISK$USER1, DISK$USER2, and 
DISK$USER_SET by default. 


If you mount USER_SET at a later time, you could include a logical name for the set in 
the MOUNT command. In that case, the system would not create the default logical name | 
in the form DISK$volume_set_name. For example, the following command includes the 
logical name USERS, which can be used as the name of the volume set in subsequent 
commands. 


$ MOUNT/SYSTEM DEV1,DEV2 USER1,USER2 USERS 


The user copies a file from a work disk to a directory on the volume set. (The [SMITH] 
directory already existed on the USER1 volume. It is now a directory on the volume set.) 
The system stores the file on the volume in the set that has the most unused space. 


To dismount an entire volume set, use the DISMOUNT command and specify any one of 
the devices containing a member of the volume set. To dismount a single volume of a 
volume set, use the /UNIT qualifier. Since the volume set was mounted using the /SYSTEM 
qualifier, the devices have already been deallocated. Therefore, they are now available for 
other users. 


When you dismount a volume set, the system deletes the logical names it created during 
the mount procedure. 
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USING DISK QUOTAS TO MANAGE DISK SPACE 
USAGE 


The UAF restricts use of many system resources, but there is no value in the UAF record that 
restricts use of disk space. 


Disk space restriction is handled through disk quotas. Quotas are based on UICs, not 
individual user names. 


Disk quotas are managed through use of the SYSMAN utility DISKQUOTA command subset. 
Disk quotas are enabled on a volume-by-volume basis; the default is no disk quotas enabled. 
Quota files: 

* One file per enabled volume: [OOOOO0JQUOTA.SYS 

« Contains quota entries, one per UIC 


¢ Created and manipulated by the SYSMAN utility 
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Establishing Quotas on a Volume 


A quota file must be created in the volume’s MFD (directory [000000]). Exact steps for properly 
creating the quota file depend on whether: 


* The volume has just been created (no user files exist) 


« The volume has been in use for a while (user files already exist) 


One entry must be created for each UIC allowed to use the volume. Each quota entry contains 
the following fields: 


> Ulc 
« Usage 
¢ Permanent quota 


* Overdraft 


NOTE 
Quotas should not be enabled on the system disk. 
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Table 1—2 illustrates establishing quotas on a new volume. 


Table 1-2 Establishing Quotas on a New Volume Called DISK$DATA 


Steps Commands 
1 Log in as SYSTEM 


$ RUN SYSSSYSTEM: SYSMAN 


SYSMAN> DISKQUOTA CREATE - 
_SYSMAN> /DEVICE=DISKSDATA 


Comments 


You can alternatively give your current process 


OPER privilege to use the SYSMAN utility. 


Table 1-3 shows the fields in a quota file record. 


Table 1-3 Fields in a Quota File Record 


Field 


UIC 


Usage 


Permanent 
Quota 


Overdraft 


Meaning 


Identifies the user who is permitted to use 
the volume. Note that files are owned by 
UICs, not by user names. Therefore, if more 
than one user shares the same UIC, all of 
them have the same access to files. They 
also share the quota assigned to that UIC 
for the volume. When you log in, the VMS 
system reads your UAF record to determine 
your UIC. 


Shows the number of blocks of storage this 
UIC owns. 


Determines the number of blocks of storage 
this UIC can own before the VMS system 
refuses to create new files or extend existing 
files. If the UIC has an Overdraft value 
greater than 0, a user with this UIC can retry 
the file operation (create or extend). 


Determines the number of blocks above the 
permanent quota this UIC can own before 
the VMS system refuses to create new 
files or extend existing files. Therefore, the 
permanent quota plus the overdraft define 


the total number of blocks available to a user 


on a volume. 


Invokes the SYSMAN utility. 


The file DISK$DATA:[(OO0000]QUOTA.SYS is 
created and quotas are automatically enabled 
on the volume. 


DISKQUOTA Qualifier 


Specify the UIC as a 
parameter, not as a qualifier, 
in DISKQUOTA commands. 


None. This value is updated 
by the VMS system as files 

are created by the UIC. It is 
not assigned by the system 

manager. 


/PERMQUOTA 


/OVERDRAFT 
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Figure 1-2 Adding a Quota Record to a Volume Quota File 


$ RUN SYS$SYSTEM:SYSMAN 
SYSMAN> DISKQUOTA ADD [11,2]- 


_SYSMAN> /DEVICE=DISK$DATA 
SYSMAN> EXIT 
$ 





SYSTEM MANAGER 









VOLUME QUOTA FILE 
[O00000JQUOTA.SYS 
FOR VOLUME 
DISK$DATA 


RECORD: UIC [11,2] 





$ SET DEFAULT DISK$DATA 
$ CREATE [SMITH]JFILE.DAT 


USER WITH UIC [11,2] 


TTB_X0474_88A 
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Example 1—7 shows output from the SYSMAN DISKQUOTA SHOW command. 


Example 1-7 List of Volume Quota File Records 


$ RUN SYSS$SYSTEM: SYSMAN 
SYSMAN> DISKQUOTA SHOW [*,*] /DEVICE=DISKSUSER 


UIC Usage Permanent Quota Overdraft Limit 
[0,0] 0 690 200 
[SYSTEM] 12047 13000 200 
{[VMS, BEYER] 11685 15000 200 
pli; 56 56 200 
[VMS , CLARK ] 16233 20000 200 
[VMS , DORSEY] 13510 20000 200 
{VMS , HARKINS } 18221 20000 200 
[VMS , HUNT] 21060 30000 200 
{11,340] 22905 30000 200 
[VMS , DISALVO] 9021 18000 200 
(VMS, TARGONSKT ] 2425 4000 200 
[12,1] 4 690 200 
[BEYER2] 142 144 200 
[GROUP21,ALBERT] 14137 20000 200 
[21,10] 10 690 200 
P21 720) Z 690 200 
[GROUP 21,EBERT] 5962 12000 200 
[GROUP21, GALVIN} 3295 5000 200 
{GROUP21,TATAR] 32 2000 200 
[siya] Z 2 200 
[GROUP 31, HARBO] 6117 10000 200 
[GROUP 31, CONNOR] 3261 8000 200 
{[PAPISON] 666 690 200 
{[CHERPAS ] 19 690 200 
[GROUP101, ALCOCK] 29806 30000 200 
[GROUP101, LUCAS] 21202 30000 200 
[GROUP101,MASORS] 125 690 200 
[GROUP101, WILSON] 20968 25000 200 
[i23;,321)] 20 690 200 
[DATA COMM, DELLA] 12931 20000 200 
[DATA _COMM, LENTZ] 6341 20000 200 
[200, 3] Z 690 200 
[200,200] 60 690 200 
[DECNET] 78 690 200 
[J65,DOE] 4 100 100 
SYSMAN> EXIT 


$ 
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Table 1—4 lists commands for displaying the contents of a volume quota file. 


Table 1-4 Displaying the Contents of a Volume Quota File 
Operation SYSMAN Command Format 
Displays the entry of a particular user DISKQUOTA SHOW [uic] 


Displays the entries of all users with UICs in a DISKQUOTA SHOW [group-nunber, *] 
particular group 


Displays the entries for all users DISKQUOTA SHOW [*, *] 
Displays DISKQUOTA commands HELP DISKQUOTA 


NOTE 


The disk volume usage recorded by the VMS system and displayed by 
SYSMAN includes some overhead. Therefore, the disk usage displayed by 
the SYSMAN command DISKQUOTA SHOW and the DCL command SHOW 
QUOTA is usually different from the disk usage displayed by the DCL 
command DIRECTORY/SIZE=ALLOCATED. 


Table 1—5 illustrates SYSMAN DISKQUOTA commands. 


Table 1-5 Managing Individual Records in the Volume Quota File 


Operation ' SYSMAN Command Format 
Adds a new entry, specifying values SYSMAN>DISKQUOTA ADD uic - 
different from the default entry ([0,0]) _SYSMAN> [/PERMQUOTA=blksl] [/OVERDRAFT=blks2] 
Modifies an existing entry SYSMAN>DISKQUOTA MODIFY uic - 

_SYSMAN> [PERMQUOTA=blks1] [/OVERDRAFT=blks2] 
Modifies the entry for [0,0], used to SYSMAN>DISKQUOTA MODIFY [0,0] - 
supply default values for permanent _SYSMAN> [/PERMQUOTA=blks1] [/OVERDRAFT=blks2] 


quota and overdraft. ({0,0] should 
never own any files.) 


Modifies all entries for UICs in a SYSMAN>DISKQUOTA MODIFY [group-number, *] - 
particular group _SYSMAN> [/PERMQUOTA=blksl] [/OVERDRAFT=blks2] 
Modifies all entries, including the SYSMAN>DISKQUOTA MODIFY [*,*] - 

default entry, [0,0] _SYSMAN> [/PERMQUOTA=blks1] [/OVERDRAFT=blks2] 
Removes an existing entry SYSMAN>DISKQUOTA REMOVE uic 


' The SYSMAN utility performs all operations on the current QUOTA.SYS file. The current file is the 
one on your current default device if you did not specify one with the /DEVICE qualifier. Be sure to 
specify the proper volume for your command; otherwise, the most recently used /DEVICE qualifier sets 
the current file specification. 
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Establishing Quotas on an Existing Volume 


Table 1-6 illustrates establishing quotas on an existing volume whose logical name is 
DISK$USER. 


Table 1-6 Establishing Quotas on an Existing Volume Called DISK$USER 


Step 
1 


Commands 


Notify users that DISK$USER will be 
unavailable 


$ RUN SYSSSYSTEM: SYSMAN 


SYSMAN> DISKQUOTA - 


_SYSMAN> CREATE /DEVICE=DISKSUSER 


SYSMAN> DISKQUOTA MODIFY [0,0] - 


_SYSMAN> /PERMQUOTA=10000 - 
_SYSMAN> /OVERDRAFT=1000 


SYSMAN> DISKQUOTA REBUILD 


SYSMAN> EXIT 


Notify users that DISK$USER is 
available for use 


Comments 


The REPLY command and the Mail utility are 
two possible methods. 


Invokes the SYSMAN utility. Make sure your 
current process has OPER privilege (to use 
the SYSMAN utility) and SYSPRV privilege 
(to issue DISKQUOTA commands). 


Creates a quota file on the DISK$USER 
volume (DISKSUSER:[000000j]QUOTA.SYS) 
and automatically enables quotas on that 
volume. 


Sets the default entry values for 

the quota file on DISK$USER. Use 
appropriate values for /PERMQUOTA and 
/OVERDRAFT to reflect your management 
policy on the volume. Note that the 
/DEVICE=DISK$USER qualifier need not 
be specified, as the qualifier was properly 
specified in step 3. 


Updates the newly created quota file to 

add existing UICs that own files on the 
DISK$USER volume. Note that the 
/DEVICE=DISK$USER qualifier need not be 
specified in this case. 


Exits from the SYSMAN utility. 
See step 1. 
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Disabling and Enabling Quotas on a Volume 
To disable quotas, use the SYSMAN DISKQUOTA DISABLE command. 


Use the SYSMAN DISKQUOTA REBUILD command to properly assess user space on a 
volume if: 


¢« The volume previously had a quota file created 
* Quotas were once enabled on the volume 


* Quotas were later disabled 


An automatic DISKQUOTA REBUILD is performed when a volume is mounted after being 
improperly dismounted. This is a typical situation after a system failure. 


ne 4 endhed 
oy Leni 
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SETTING FILE CHARACTERISTICS 


Another way to manage the use of disk space is to use the SET FILE command, which modifies 
the characteristics of files. 


¢ Format: 
$ SET FILE/qualifier(s) file-spec 
¢ The file-spec specifies one or more files to be modified. 


— lf you specify more than one file, separate them with commas. 
(Wildcard characters are allowed.) 


« Some of the file characteristics you can modify are listed in Table 1-7. 
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Table 1-7 Some Qualifiers for the SET FILE Command 


Qualifier 

Specifying File Characteristics 
/EXPIRATION_DATE=date 
/NOEXPIRATION_DATE 


/VERSION_LIMIT/=n] 


/OWNER_UIC/=uic] 


/Prt=(..) 


Description 


Assigns an expiration date to. the specified files. Later, you 
can use DELETE/EXPIRED to delete files whose expiration 
date has passed. 


Specifies the maximum number of versions allowed for the 
specified file. If the version limit is exceeded, the earliest 
version of the file is deleted from the directory without 
notification to the user. 


Specifies an owner UIC for the file. The default is the UIC 
of the current process. Useful if you create a file in a user’s 
directory and you want the user to own the file. 


VMS records the use of disk space on a UIC basis, so 
changing the owner UIC of a file changes which disk quota 
entry the space is recorded under. 


Modifying the Action of the SET FILE Command 


/BY_OWNER{=uic] 


/CONFIRM 
/NOCONFIRM 


/EXCLUDE=(file-specy....)) 


/LOG 


Selects only those files whose owner UIC matches the 
specified UIC. The default is the UIC of the current process. 


Controls whether a request is issued before each SET FILE 
operation to confirm that the operation should be performed on 
that file. The default is /NOCONFIRM. 


Excludes the specified file from the SET FILE operation. 
(Wildcard characters are allowed.) 


Displays the file specification of each file modified as the 
command executes. 


Example 1-8 illustrates the use of some of these qualifiers. 


y, Ew (eR = Aw ~1tyrew& 
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Example 1-8 SET FILE Command 


@ $ DIR/FULL TEST.COM 
Directory WHYSOSDUAO: [ROUNDS] 


TEST .COM;1 File ID: (1620,1,0) 
@ size: 1/3 Owner: [ROUNDS] 

Created: 9-JUN-1990 14:25:03.66 

Revised: 22-MAY-1991 16:00:20.22 (3) 


Expires: <None specified> 

Backup: <No backup recorded> 

File organization: Sequential 

File attributes: Allocation: 3, Extend: 0, Global buffer count: 

No version limit 

Record format: Variable length, maximum 12 bytes 

Record attributes: Carriage return carriage control 

RMS attributes: None 

Journaling enabled: None 

File protection: System:RWED, Owner:RWED, Group:RE, World: 
. Access Cntrl List: None 


Total of 1 file, 1/3 blocks. 


$ 
@s SET FILE /OWNER=MARSH /EXPIRATION DATE=0 /VERSION_LIMIT=3- 
$ /LOG TEST.COM 


© ssET-I-MODIFIED, WHYSOSDUAO: [ROUNDS] TEST.COM;1 modified 


$ 
@ s DIR/FULL TEST.COM 
Directory WHYSOSDUAO: [ROUNDS] 


TEST.COM;1 File ID: (1620,1,0) 
@ size: 1/3 Owner: [MARSH] 
Created: 9-JUN-1990 14:25:03.66 
Revised: 25-MAY-1991 11:21:37.92 (4) 
Expires: 25-MAY-1991 00:00:00.00 
Backup: <No backup recorded> 
File organization: Sequential 


File attributes: Allocation: 3, Extend: 0, Global buffer count: 


‘Version limit: 3 
Record format: Variable length, maximum 12 bytes 
Record attributes: Carriage return carriage control 
RMS attributes: None 
Journaling enabled: None 
File protection: System: RWED, Owner:RWED, Group:RE, World: 
Access Cntrl List: None 


Total of 1 file, 1/3 blocks. 
$ 


(Notes on Example 1—8 are shown on the next page.) 
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Notes on Example 1-8: 


oOo 8 8 o 6 6 8 


Display full directory information about TEST.COM. 
The owner UIC of the file is [ROUNDS]. 

The file has no expiration date. 

The file has no version limit. 


Change several characteristics of the file and request that the name of the file be displayed 
when the operation takes place. 


The log message. 


Redisplay the directory information. 


The owner UIC of the file is now [MARSH]. 


The file now has an expiration date that defaults to the current date since 0 was specified 
as the date. 


The file now has a version limit of 3. 
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SUMMARY 


Disk and tape drives are devices that record and read data on magnetic media or optical disks. 


Every device has a unique name in the format of ddcu. 

There are two formats used in naming devices in a VAXcluster system: 
— node$device 

— f$allocation-class$device 


The MOUNT/CLUSTER command mounts a volume on every node that is currently a 
member of the cluster, and the DISMOUNT/CLUSTER command dismounts a volume on 
every cluster node that has it mounted. 


To suppress a volume rebuild, which can cause processes (or the entire cluster in the case 
of a system disk) to hang, use the MOUNT/NOREBUILD command. 


— The disk should be rebuilt later with the SET VOLUME/REBUILD command. 
The SHOW DEVICE command is used to obtain information about disk volumes. 


The SET FILE command can be used to modify file characteristics including expiration 
date, version limit, and owner UIC. 


The SYSMAN utility is used to set quotas on the use of disk space. Use it to: 
— Establish disk quotas on a volume, whether it is new or already in use 


— Add user entries to the quota file on a disk volume 
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Using Logical Name Tables 


INTRODUCTION 


Logical names provide the VMS user with a convenient way of referring to programs, command 
procedures, disk locations, and other objects without having to know their physical location. 
Users can define their own logical names, and the system manager can also define logical 
names to make them available to users. 


The VMS operating system stores all system-defined and user-defined logical names in tables, 
called logical name tables. 


This chapter describes the features related to logical name tables. 
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OBJECTIVES 


To further customize the VMS working environment, a system and network manager needs to 
be able to: 


¢« Determine the equivalence of a logical name 
* Display the contents of logical name tables 
« Use and identify some system-created logical names 


¢ Define logical names in the system table 
RESOURCES 


* Guide to Using VMS Command Procedures 
¢ VMS DCL Dictionary 

¢ Guide to Using VMS 

¢« VMS User’s Manual 

¢ VMS DCL Concepts Manual 


TOPICS 


* Logical name tables 

¢ Logical name translation 

* Search lists 

« System-created logical names 

¢ Defining names in the system table 


¢ Duration of logical names 
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LOGICAL NAME TABLES 


The system stores logical names and their equivalence strings in four default logical name 
tables and possibly additional user-defined tables: 


- Process logical names 
— Used only by your process 
— Stored in process logical name table 
« Job logical names 
— Shared by your process and all of its subprocesses 
— Stored in job logical name table 
— DCL commands that use this table include the qualifier /JOB 
¢ Group logical names 
— Shared by all processes in a UIC group 
— Stored in group logical name table 
— GRPNAM privilege is needed to add logical names to this table 
— DCL commands that use this table include the qualifier /GROUP 
- System logical names 
— Shared by all processes on the system 
— Stored in system logical name table 
— SYSNAM privilege is needed to add logical names to this table 
— DCL commands that use this table include the qualifier /SYSTEM 
* Other logical names 
— Used for special applications 


— For example, the table DECW$LOGICAL_NAMES holds logical names used by 
DECwindows software 


— DCL commands that use these tables include the qualifier /TABLE= 
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Figure 2-1 illustrates the relationship between your terminal, the operating system, and the 
logical name tables associated with your process. 


Figure 2-1 Relationship Between Your Terminal, the Operating System, and Logical 
Name Tables 
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2-6 Using Logical Name Tables 


The SHOW LOGICAL command, shown in Example 2-1, displays the contents of all logical 
name tables to which you have access. 


Example 2-1 Displaying the Contents of Logical Name Tables 


$ SHOW LOGICAL 


(LNMSPROCESS_ TABLE) 


"SYSSCOMMAND" = " TIDYSLAT2:" 
"SYSSDISK" = "TIDYSDJAO:" 
"SYSSERROR" = " TIDYSLTA2:" 
"SYSSINPUT" = " TIDYSLTA2:" 
"SYSSOUTPUT" [super] = "_TIDYSLTA2:" 
"SYSSOUTPUT" [exec] = “ TIDYSLTA2:" 
i TT" = LTA? : Li) 


(LNMSJOB_803DD220) 


"SYSSLOGIN" = "TIDYSDJAO: [HENDRICKS]" 
"SYSSLOGIN DEVICE" = "TIDYSDJAO:" 
"SYSSSCRATCH" = "TIDYSDJAO: [HENDRICKS]" 


(LNMSGROUP_000011) 
(LNMSSYSTEM_ TABLE) 


"ACPSBADBLOCK_MBX" = "MBA4:" 
"DBGSINPUT" = "SYSSINPUT:" 
"DBGSOUTPUT" = "SYSSOUTPUT:" 
"SYSSSTARTUP" = "SYSSSYSROOT: [SYSSSTARTUP] " 
= "SYSSMANAGER" 
"SYSSSYLOGIN" = "SYSSMANAGER: SYLOGIN.COM" 
"SYSSSYSDEVICE" = "TIDYSDJAO:" 
"SYSSSYSDISK”" = "SYSSSYSROOT =" 
"SYSSSYSROOT" = "TIDYSDJAO: [SYSO.]" 
= "SYSSCOMMON:" 
"SYSSSYSTEM" = "SYSSSYSROOT: [SYSEXE] " 
"SYSSTEST" = "SYSSSYSROOT: [SYSTEST]" 
"SYSSTOPSYS" = "SYSO" 
"SYSSUPDATE” = "SYSSSYSROOT: [SYSUPD] " 
"SYSSWELCOME" = "@SYSSMANAGER: WELCOME. TXT" 


"TPUSSECTION" = "EVESSECTION" 
(DECWSLOGICAL NAMES) 


"CDASLIBRARY" = "SYSSCOMMON: [CDASLIBRARY]" 
"DECWSBOOK" = "SYSSCOMMON: [DECWSBOOK]" 


"DECWSEXAMPLES" = "SYSSCOMMON: [SYSHLP.EXAMPLES.DECW] " 
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Example 2—2 shows how to display the contents of the process, job, group, system, and 
DECwindows logical name tables using the /PROCESS, /JOB, /GROUP, /SYSTEM, and /TABLE 
qualifiers. 


Example 2-2 Displaying the Contents of Logical Name Tables 


$ SHOW LOGICAL/PROCESS 
(LNMSPROCESS_ TABLE) 


"SYSSCOMMAND" = " TIDYSLTA12:" 
"SYSSDISK" [super] = "VMSSCOM:" 
"SYSSDISK" [exec] = "VMSSCOM:" 
"SYSSERROR" = " TIDYSLTA12:" 
"SYSSINPUT" = "_TIDYSLTA12:" 
"SYSSOUTPUT" [super] = "_TIDYSLTA12:" 
"SYSSOUTPUT" [exec] = " TIDYSLTA12:" 


$ SHOW LOGICAL/JOB 
(LNM$JOB_ 803E4E40) 


"SYSSLOGIN" = "DISK: [SMITH]" 
"SYSSLOGIN DEVICE" = "DISK:" 
"SYSSSCRATCH" = "DISK: [SMITH]" 


$ SHOW LOGICAL/GROUP 
(LNMSGROUP_000011) 
"GROUP11_ DISK" = "DJAO:" 
$ SHOW LOGICAL/SYSTEM 
(LNMSSYSTEM TABLE) 


"DBGSINPUT" = "SYSSINPUT:" 
"DBGSOUTPUT" = "SYSSOUTPUT:" 


$ SHOW LOGICAL/TABLE=DECWSLOGICAL NAMES 
(DECWSLOGICAL NAMES) 


"CDASLIBRARY" = "SYSSCOMMON: [CDASLIBRARY]" 
"DECWSBOOK" = "SYSSCOMMON: [DECWSBOOK]" 
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LOGICAL NAME TRANSLATION 


The system translates logical names automatically. 


By default, logical name tables are searched for the first occurrence of a logical name in 
the following order: 


1. Process logical name table 

2. Job-wide logical name table 

3. Group logical name table 

4. System logical name table 

5. Other logical name tables (for example, the DECwindows table) 


The leftmost portion of a file specification is translated to see if it is a logical name. 


Determining the Equivalence of a Logical Name 


Two commands are available to determine the equivalence of a logical name. 
Command format: 
— $ SHOW LOGICAL logical-name 
lteratively translates the logical name up to 10 levels 
— §$ SHOW TRANSLATION logical-name 


Displays the first equivalence string it finds and stops (no iteration is performed) 


Translation is done:. 


_— Up to 10 times (recursively) 


— Until there are no more equivalence names to be translated 


— Until the leftmost component of the specification is not delimited by a colon, a space, 
a comma, or an end of line 


— Until equivalence name is a logical name that has the TERMINAL attribute. If a logical 
name has the TERMINAL attribute, the translation is "TERMINAL" (completed) after 
the first translation 


— If the logical name has the CONCEALED attribute, the translation normally displays 
the logical name for the device, rather than the physical name for the device 


Example 2-3 shows both commands used to determine a logical name value. 
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Example 2-3 Determining the Value of a Logical Name 


Os 
Os 
Os 


Os 


1 


ASSIGN DJAO: DISK1 
ASSIGN DISK1: MYNAME 


SHOW TRANSLATION MYNAME 
MYNAME = "DISK1:" (LNMSPROCESS_ TABLE) 
SHOW LOGICAL MYNAME 
"MYNAME" = "DISK1:" (LNMSPROCESS_ TABLE) 
"DISK1" = "DJAO:" (LNMSPROCESS TABLE) 


Notes on Example 2-3 


1 
2] 


Create a logical name, DISK1, that translates into the string "DJAO:". 
Create a second logical name, MYNAME, which translates to the string "DISK1". 


When you display the equivalence of a logical name using the SHOW TRANSLATION 
command, only one level of translation occurs. 


Note that the SHOW LOGICAL command translates the logical name iteratively. 
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Modifying Logical Name Translation 


When creating a logical name, you can establish translation attributes that modify the 
interpretation of an equivalence name. 


« Use the /TRANSLATION_ATTRIBUTES qualifier with the ASSIGN or DEFINE command. 
¢ Two translation attributes are available: 

— TERMINAL 

— CONCEALED 


Preventing Iterative Translation 
The TERMINAL attribute prevents iterative translation of a logical name. 
« The equivalence name is not examined to see if it is also a logical name. 


« The translation is terminal (complete) after the first translation. 


Concealing the True Identity of a Logical Name 


The CONCEALED attribute causes the logical name of a device, rather than the physical name, 
to be displayed in system messages. This technique allows you to: 


* Use aname that is more meaningful to users than the physical device name 


¢ Hide physical device names from users, so that you can change a physical device without 
affecting users 
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Example 2-4 shows the use of the CONCEALED attribute. 


Example 2-4 CONCEALED Attribute 


$ ASSIGN/SYSTEM DUAO: USERDISK 
S$ DIRECTORY USERDISK: [ROUNDS] 


Directory DUAO: [ROUNDS] 


TEST.COM;5 TEST.DIR;1 
Total of 2 files. 
$ 


$ ASSIGN/TRANSLATION_ATTRIBUTES=CONCEALED/SYSTEM DUAO: USERDISK 
%DCL-I-SUPERSEDE, previous value of USERDISK has been superseded 
$ DIRECTORY USERDISK: [ROUNDS] 


Directory USERDISK: [ROUNDS] 
TEST .COM;5 TEST.DIR;1 
Total of 2 files. 


Once you have defined a concealed logical name for a device, you may want to epee itas a 
user’s default device name, as shown in Example 2-5. 


Example 2-5 Assigning a User to a Logical Default Device 


$ RUN SYS$SYSTEM: AUTHORIZE 
UAF> MODIFY ROUNDS /DEFAULT=USERDISK 
UAF> SHOW ROUNDS 


Username: ROUNDS Owner: Kristin Rounds 
Account: GROUP22 UIC: [22,456] ([GROUP22, ROUNDS] ) 
CLI: DCL Tables: 


Default: USERDISK: [ROUNDS] 
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SEARCH LISTS 


A search list is a logical name that has more than one equivalence string. You can use a search 


list in any place that you can use a logical name. 
Example 2-6 demonstrates the use of search lists. 


Example 2-6 Search Lists 


@ $s DIRECTORY 
%SDIRECT-W-NOFILES, no files found 
$ 

@s CREATE MON .DAT, TUE,WED,THU,FRI 
This is MON[CTRL/Z 
This is TUE]CTRL/Z| 
This is WED/CTRL/Z |] 
This is THU|CTRL/Z| 
This is FRI]CTRL/Z| 












$ 
© s DIRECTORY 
Directory TEST DISK: [ROUNDS] 


FRI.DAT;1 
WED.DAT;1 


MON .DAT;1 THU.DAT;1 


Total of 5 files. 
$ 
Os DEFINE DAY MON.DAT,TUE.DAT,WED.DAT, THU.DAT,FRI.DAT 


$ 
@s SHOW LOGICAL DAY 
"DAY" = "MON.DAT" (LNMSPROCESS TABLE) 
"TUE. DAT" 
"WED. DAT" 
"THU. DAT" 
"FRI.DAT" 


$ 
@s DIRECTORY DAY 


Directory TEST DISK: [ROUNDS] 


MON. DAT; 1 
FRI.DAT;1 


TUE.DAT;1 WED.DAT; 1 


Total of 5 files. 


$ 
@s TYPE DAY 
This is MON 


$ 
@ $s DELETE/LOG MON.DAT; 


TUE.DAT; 1 


THU.DAT;1 


SDELETE-I-FILDEL, TEST DISK: [ROUNDS]MON.DAT;1 deleted (3 blocks) 


$ 
@s TYPE pay 
This is TUE 


(Notes on this example are shown on the next page) 
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Notes on Example 2-6: 


C7) 
e 


Check to see if there are any files in this directory. 
Create five files with one command. 


The file type of the first file carries over to the other files because no file type was specified 
for them. 


Display the names of the files in the directory. 
(Note that the names are shown in alphabetical order.) 


Create the logical name DAY, which is a search list because it has more than one 
equivalence name. 


Display the equivalences of the logical name DAY. 
(Note that they are listed in the order in which they were specified in the DEFINE command.) 


Request directory information by specifying the logical name. 
(Note that the file specifications are shown in the order of the search list.) 


Display the contents of the file that corresponds to the logical name DAY. 
(Note that this file is the first element in the search list.) 


Delete MON.DAT, the first element in the search list. 


Now the logical name DAY is translated to TUE.DAT, and the contents of that file will be 
displayed. 
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Using Commas in Logical Name Assignments 
¢« The presence of a comma generally indicates a search list. 


¢ Sometimes you may want to use a comma as part of the actual equivalence string to save 
some typing in MAIL. 


You must enclose the equivalence string in quotation marks to indicate that the comma is 
a valid part of the string. 


* Example 2-7 shows commas in logical name assignments. 


Example 2-7 Commas in Logical Name Assignments 


@ $s DEFINE REVIEW BOOT, VASSILOS, APON 
$ MAIL 


MAIL> SEND 

To: REVIEW 

Subj: THIS IS A TEST 

Enter your message below. Press CTRL/Z when complete, or CTRL/C to quit: 


@ MAIL> EXIT 


$ 

@s DEFINE REVIEW "BOOT, VASSILOS, APON" 
%DCL-I-SUPERSEDE, previous value of REVIEW has been superseded 
$ MAIL 


MAIL> SEND 

To: REVIEW 

Subj: THIS IS ANOTHER TEST 

Enter your message below. Press CTRL/Z when complete, or CTRL/C to quit: 


@ New mail on node WHYNOT from APON "Fred Apon" (20:25:58) 
MAIL> EXIT 


Notes on Example 2-7: 
@ Define the logical name REVIEW, which contains commas in its string. 
@ Senda MAIL message, using REVIEW as the recipient. 


© The sender, APON, does not receive the message. APON is the third element in a search 
list, and a match is found before that element is reached. 


@ Redefine the logical name REVIEW, enclosing the equivalence string in quotation marks to 
include the commas as part of the equivalence string. 


@ This time APON receives the message. 
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SYSTEM-CREATED LOGICAL NAMES 


Process and Job Logical Names 


Process and job logical names are available to your process. Table 2—1 describes some 
system-created logical names. 


Table 2-1 Process and Job Logical Names Defined by the System 


Logical Name 
SYS$INPUT 


SYS$COMMAND 


SYS$ERROR 


SYSSOUTPUT 


TT 


SYS$LOGIN 


SYS$LOGIN DEVICE 


SYS$DISK 


SYS$NET 


Equivalence Name 


Default input device or default file from which DCL reads input. 
For interactive use, SYS$INPUT is the terminal. While a command 
procedure is running, SYS$INPUT is the command procedure. 


The initial file (usually your terminal) from which DCL reads input. 
(A file from which DCL reads input is called an input stream.) The 
command interpreter uses SYS$COMMAND to “remember” the 
original input stream. 


Default device to which the system writes messages generated by 
warnings and errors. For an interactive user, SYS$ERROR is the 
terminal. 


Default output device. For an interactive user, SYS$OUTPUT is 
the terminal. (A file to which DCL writes output is called an output 
stream.) 


Default device name for your interactive terminal. 


Default disk and directory established at login time. Specified in the 
user authorization record by the system manager. 


Default disk established at login time. Specified in the user 
authorization record by the system manager. 


Default disk established at login. Changed by the SET DEFAULT 
command. 


The source process that invokes a target process in DECnet 
task-to-task communication. When opened by the target process, 
SYS$NET represents the logical link over which that process can 
exchange data with its partner. SYS$NET is defined only during 
task-to-task communication. 
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System Logical Names 
System logical names are available to all users on the system. 


Table 2~-2 lists some of the system logical names commonly used by the system manager. 


Table 2-2 Some of the System Logical Names Defined by the System 


Logical Name Equivalence Name 

SYS$SYSDEVICE Device on which the VMS operating system files reside 

SYS$COMMON Root directory for VMS system files shared by nodes in a 
cluster 

SYS$SPECIFIC Root directory for VMS system files specific to a single node in 
a Cluster 

SYS$SYSROOT Root directory for VMS system files; points to both 


SYS$COMMON and SYS$SPECIFIC 


SYS$MANAGER Default device and directory for the SYSTEM account; contains 
some system data files such as the operator log 


SYS$SYSTEM Device and directory containing operating system programs 
and other system files 


SYS$STARTUP Device and directory containing command procedures that are 
executed when the system starts up 


SYS$NODE Network node name for the local system, if DECnet software 
is active on the system 
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Redefining System-Created Logical Names 


Redefining SYSSOUTPUT 


You can redefine SYS$OUTPUT to redirect output from your default device to another file. 


In the following example, the display produced by SHOW DEVICES is directed to 
MYFILE.LIS in your default directory rather than to your terminal: 


$ 
$ 
$ 


nM 


ASSIGN MYFILE.LIS SYSSOUTPUT 
SHOW DEVICES 
DEASSIGN SYSSOUTPUT 


Remember to deassign SYS$OUTPUT, or output will continue to be written to the file you 
have specified. 


You can redefine SYS$OUTPUT to redirect output from an image, using the 
ASSIGN/USER_MODE command. 


— Once the image exits, SYS$OUTPUT resumes its default value. 


ASSIGN/USER_MODE MYFILE.LIS SYSSOUTPUT 
SHOW DEVICES 
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DEFINING NAMES IN THE SYSTEM TABLE 


Defining Logical Names Clusterwide 


To define the same system logical name on every node of a cluster, you can use the SYSMAN 
utility. 


$ SET DEFAULT SYSSSYSTEM 
$ SET PROCESS/PRIVILEGE=SYSPRV 
S RUN SYSMAN 
SYSMAN> SET ENVIRONMENT/CLUSTER 
SSYSMAN-I-ENV, current command environment: 
Clusterwide on local cluster 
Username SYSTEM will be used on nonlocal nodes 


SYSMAN> DO ASSIGN /SYSTEM /TRANSLATION=CONCEALED $1SDUA9: NEWDISK 
SSYSMAN-I-OUTPUT, command execution on node BARNUM 
SSYSMAN-I-OUTPUT, command execution on node RNGLNG 
SSYSMAN-I-OUTPUT, command execution on node LION 
SSYSMAN-I-OUTPUT, command execution on node HORSE 
SSYSMAN-I-OUTPUT, command execution on node BAILEY 
SSYSMAN-I-OUTPUT, command execution on node BEAR 
SSYSMAN-I-OUTPUT, command execution on node TIGER 


SYSMAN> | CTRL/Z 


Defining Logical Names Permanently 


To permanently assign a system logical name, place a DCL command to assign it in the 
command procedure SYS$STARTUP:SYLOGICALS.COM. 


« Remember to use the appropriate attributes, such as /TRANSLATION=CONCEALED. 
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DURATION OF LOGICAL NAMES 


A process or job logical name assignment lasts until you: 
* Log out (or otherwise stop the process) 


— Job logical name assignments last until the last process in the job logs out or is 
stopped. 


¢ Assign the logical name to a different string 


¢« Remove the logical name with the DEASSIGN command 


A group or system logical name assignment lasts until: 
¢ You shut down the system 

* The system fails 

« You assign the logical name to a different string 


¢ You remove the logical name with the DEASSIGN command 


If you always want to assign a process or job logical name, put the assignment statement in 
your LOGIN.COM procedure. If you always want to assign a system logical name, put the 
assignment statement in SYS$STARTUP:SYLOGICALS.COM. 
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SUMMARY 


* The system stores logical names and their equivalence strings in four default logical name 
tables and possibly additional user-defined tables: 


— Process 

— Job 

— Group 

— System 

— User-defined 


* Two commands, SHOW LOGICAL and SHOW TRANSLATION, are available to determine 
the equivalence of a logical name. 


¢ Translation attributes TERMINAL and CONCEALED are used to modify the interpretation 
of the equivalence of a logical name. 


* The system creates some job, process, and system logical names automatically. 
¢ Redefining some system logical names is useful for redirecting input and output. 
¢ Process and job logical name assignments last until the user: 

— Logs out 

— Assigns the logical name to a different string 

— Removes the logical name with the DEASSIGN command 
¢ Group and system logical names last until: 

— You shut down the system 

— The system fails 

— You assign the logical name to a different string 


— You remove the logical name with the DEASSIGN command 
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Queue Management 


INTRODUCTION 


This chapter introduces the concepts of queue management. Among the topics discussed are: 


The VMS system queue facilities 
How the VMS system handles print and batch queues 
Monitoring print and batch queues 


VAXcluster queue management 
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OBJECTIVES 


To describe the tasks and responsibilities involved in queue management, a system and network 
manager should be able to: 


¢ Describe what queue facilities are and how the VMS system uses them 
¢ Monitor print and batch queues 


« Set up and manage queues in a VAXcluster system 


RESOURCES 


¢« VMS DCL Dictionary 
* VMS System Manager’s Manual 
* Guide to Setting Up a VMS System 


* Guide to Maintaining a VMS System 
TOPICS 


* Queue facilities and operations 

* How the VMS system handles print jobs 
* How the VMS system handles batch jobs 
* Batch queue operations 

¢ Monitoring print and batch queues 


* Managing batch and print operations in a VAXcluster system 
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QUEUE FACILITIES AND OPERATIONS 


The VMS operating system provides comprehensive facilities to dynamically manage print and 
batch queues and the jobs submitted to those queues. 


The Queue Manager 


The queue manager process (QUEUE_MANAGER) controls print and batch queues and jobs. 


¢ One queue manager performs these tasks for the entire cluster. 


¢ Starting the queue manager: 


The queue manager is automatically started when the first node of the cluster starts up 
(provided you have entered a START/QUEUE/MANAGER command in the past). 


The command STOP/QUEUE/MANAGER/CLUSTER stops the queue manager. 
The command START/QUEUE/MANAGER restarts it. 


If the node on which the queue manager is running fails, a new queue manager 
automatically starts on another node in the cluster. 


¢« The queue manager keeps track of queues and jobs in a database consisting of three 
files: 


SYS$SYSTEM:QMAN$MASTER.DAT, the master file 
SYS$SYSTEM:SYS$QUEUE_MANAGER.QMAN$QUEUES, the queue file 
SYS$SYSTEM:SYS$QUEUE_MANAGER.QMAN$JOURNAL, the journal file 


The queue manager communicates with the job controller process (JOB_CONTROL) on each 
system, which performs many system management and control tasks. 
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Types of Queues 
The VMS operating system provides two general classes of queues: 
¢« Execution 


— Accepts either batch or print jobs for processing, depending on how the queue was 
initialized (created) 


¢ Generic 


— Holds jobs until they are transferred to an assigned execution queue 


Queue classes are further defined by: 
¢ The kind of job the queue accepts 


¢ The type of device to which output is directed 
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Execution Queues 


An execution queue performs the actual processing of the job. There are two types of execution 
queues: 


* Batch 
— Can only accept (process) batch jobs 
— Executes as a detached process 

* Output 


— Accepts (typically) print jobs for processing by an independent process called 
a symbiont 


— Three types of output execution queues: 


Printer Directs output to line printers 

Terminal Directs output to terminal printers (printers attached to terminal 
lines) 

Server Processes files in the queue using a specially created symbiont 


—  Symbionts for server execution queues can be customer-written or provided as part of 
a layered product 


Not necessarily used for print output operations 
Not covered in this course 
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Generic Queues 


Generic queues are used to hold a job until an associated execution queue becomes available. 
There are two types of generic queues: 


* Generic batch queue 

— Directs jobs only to batch execution queues 

— Typically used in VAXcluster systems to distribute the workload across several nodes 
¢ Generic print queue 


— Directs jobs to any of the three types of output execution queues: printer, terminal, or 
server 


¢ The list of associated execution queues is defined when the generic queue is initialized. 


* When an execution queue becomes available, the job is requeued from the generic queue 
to the execution queue. 
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HOW THE VMS SYSTEM HANDLES PRINT JOBS 


There are several ways to print on a VMS system. A printer is controlled by a print symbiont if 
it is associated with a queue. You can: 


¢ Allocate a printer and send data interactively to it with the COPY command 
¢ Allocate a printer and send data from a program to it with the WRITE command 


¢ Use the PRINT command 


COPY and WRITE have several disadvantages: 


° If you have limited numbers of printers, you must wait until one can be allocated to your 
process. 


¢ If you have multiple users, waiting for available printers can cause time problems. 


¢ There is no capability to order print jobs by their importance or size; printing is on a 
first-allocated, first-served basis. 


These problems are solved in part by print queues. 

« The PRINT command places print jobs in print queues. 

¢ The system then decides when and where to print any particular job. 
— Print queues solve waiting and scheduling problems. 
— The PRINT command causes QUEUE MANAGER to place a job in the queue. 
— Print symbionts execute print jobs. 


— JOB_CONTROL sends jobs to print symbionts. 
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Example 3-1 shows the results of the SHOW SYSTEM command. Note the JOB CONTROL 
and SYMBIONT_0001 processes. This node does not happen to be running the queue 
manager. 


Example 3-1 JOB CONTROL and Print Symbiont Processes 


$ SHOW SYSTEM 
VAX/VMS V5.5 on node BIMBAM 14-NOV-1991 17:21:45.54 Uptime 21 09:23:21 


Pid Process Name State Pri I/O CPU Page flts Ph.Mem 
20200021 SWAPPER HIB 16 0 0 00:00:21.96 0 0 
202002A2 Chocoholic HIB 9 4000 0 00:01:00.00 6658 328 
20200263 DUFFY CUR 4 328 0 00:00:10.49 1057 299 
20200027 ERRFMT HIB 8 9995 0 00:02:59.54 82 118 
20200028 CACHE SERVER HIB 16 152 0 00:00:00.75 62 93 
20200029 CLUSTER_SERVER HIB 8 39 0 00:00:02.20 151 314 
2020002A OPCOM HIB 8 4321 0:-002027:13.76 645 214 
2020002B AUDIT SERVER HIB 10 54 0 00:00:54. 84 1300 223 

@ 2020002c JOB CONTROL HIB 8 3320 0 00:00:42.08 201 348 
2020002D CONFIGURE HIB 10 122 0 00:00:12.96 111 159 

@ 2020002E SYMBIONT_0001 HIB 6 85 0 00:00:03. 92 670 46 
2020002F SMISERVER HIB 9 104 0 00:00:03.07 406 437 
20200251 NETACP HIB 10 1493 0 0152474 58'.28 2321834 3500 
20200112 EVL HIB 5 1390 0 00:00:39.21 49642 38 N 
202001B3 REMACP HIB 9 59 0 00:00:00.56 80 50 
20200075 WOODS LEF 4 14551 0 00:09:09.52 37853 170 
20200079 RTAI1: HIB 6 22780 0 00:20:36.65 10459 4096 


Notes on Example 3-1: 
@ The JOB CONTROL process 


@ Aprint symbiont process 
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Print Job Scheduling 
After jobs are placed in the queue using the PRINT command: 
QUEUE_MANAGER process schedules the jobs using: 
* Priority 
— Job with highest queue priority executed first 
a ihe pt ges in queues limited by two sal ae 7 
DEFQUEPRI — The default queue priority assigned to all print jobs (100) 


MAXQUEPRI — The maximum queue priority any user can assign to a job (range 
is 0-255) 


— Job size 
Smaller jobs executed before larger jobs (within the same priority group) 
— Submission time 


Jobs executed in order of submission if they are same size and have same priority 


Scheduling can be changed to first-come-first-served with the qualifier /SCHEDULE=NOSIZE 
on the INITIALIZE/QUEUE or SET QUEUE command. 


Queue Management 3-11 


Example 3-2 illustrates how print jobs are scheduled by the QUEUE_MANAGER process. 
Example 3-2 Scheduling Print Jobs 


$ SHOW QUEUE LPAO/FULL 

Printer queue LPAO 
/BASE PRIORITY=4 /DEFAULT=(FLAG) /FORM=DEFAULT Lowercase 
/OWNER=[SYSTEM] /PROTECTION=(S:E,0:D,G:R,W:W) 


Entry Jobname Username Blocks Status 


228 ACTION JONES 6 Printing 
Submitted 13-DEC-1991 12:02 /FORM=DEFAULT /PRIO=100 
_DRA1: [JONES]ACTION.COM;1 /COPIES=2 


231 NOTES JONES 12 Pending 
Submitted 13-DEC-1991 12:15 /FORM=DEFAULT /PRIO=120 
_DRA1: [JONES] NOTES. TXT; 1 


230 MEMO JONES 1 Pending 

Submitted 13-DEC-1991 12:08 /FORM=DEFAULT /PRIO=100 
_DRA1: [JONES] MEMO.MEM; 1 

229 MATH JONES 6 Pending 


Submitted 13-DEC-1991 12:04 /FORM=DEFAULT /PRIO=100 
_DRA1: [JONES] MATH.LIS;1 


Notes on Example 3-2: 


@ Job 228 is currently executing. The QUEUE_MANAGER process examines the parameters 
of the pending jobs to determine which job to print next. 


@ Since Job 231 has the highest priority of the pending jobs, it will be printed next. 
NOTE 
The priority of a job in a queue is limited by two system parameters: 


¢ DEFQUEPRI — the default queue priority assigned to all print jobs 


¢ MAXQUEPRI — the maximum queue priority any user can assign to 
a job (range is 0-255). 


Regardless of the values of these parameters, users with OPER or 
ALTPRI privilege can submit jobs at any priority using the /PRIORITY 
qualifier. 


© Job 230 is smaller than Job 229, and they have the same priority, so Job 230 will be printed 
third. 


O Finally, Job 229 will be printed. However, if another job is submitted before Job 229 begins 


printing, the QUEUE MANAGER process examines the parameters of Job 229 and the 
new job to determine which job to print first. 
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Creating Print Queues 


Establishing a print execution queue requires OPER privilege. To establish a print execution 
queue: 


1. Set physical attributes of device 
¢ SET PRINTER 
¢ SET TERMINAL attributes 
2. Spool each printing device 
- SET DEVICE/SPOOLED 
3. Initialize and start an execution queue for each printing device 
« /NOENABLE_ GENERIC to prevent system from automatically moving jobs 
4. Initialize and start a generic print queue 
¢ Normaily SYS$PRINT 
5. Initialize and start a generic terminal queue 


* Use any name, TERMPRINT, for example: 


$ INITIALIZE/QUEUE/TERMINAL/GENERIC=(TTA1,TTC7) TERMPRINT 


Queue Management 3-13 


Queues can be created either: 
¢  Interactively 
or 


* In acommand procedure 


You can create and start queues using one or more commands as shown in Table 3-1. 


Table 3-1 
Command 


Initializing and Starting Queues 


$ INITIALIZE/QUEUE [/qualifiers] - 

_$ queue-name 

$ INITIALIZE/QUEUE/TERMINAL/ON=TXC2 - 
_$ LASER 


$ START/QUEUE [/qualifiers] queue-name 
S$ START/QUEUE LPAO 


$ INITIALIZE/QUEUE/START [/qualifiers] - 
_§ queue-name 
$ INITIALIZE/QUEUE/START SYSSPRINT 


Comments 


Creates the queue. If the queue is already 
running, this command has no effect. If a 
queue exists but is stopped, you can use this 
command to modify queue parameters. Jobs 
listed in the queue and new jobs execute 
under the new parameters. 


Starts a stopped queue. If the queue is 
already running, the system displays an error 
message. 


Creates and starts a queue. Include this 
command for each queue in the procedure 
SYSTARTUP_V5.COM. If the queue is 


already running, this command has no effect. 
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Table 3-2 lists commands that create and use print execution queues. 


Table 3-2 Creating and Using Print Execution Queues 


Operation 


Determine 
the device 


Set the 
device 
attributes 


Spool the 
device 


Create and 
start the 
queue 


List the 
device 
queues 


Use the 
queue 


Creating a 


Printer Queue 


S$ SHOW DEVICE L 


$ SET PRINTER - 
_$ /UPPER LPAO 


$ SET DEVICE - 
_$ /SPOOLED LPAO 


$ INITIALIZE/QUEUE - 
_$ /START/ON=LPAO —- 
_$ LINE _PRINTER 


$ SHOW QUEUE/ALL - 
_$ /DEVICE 


$ PRINT FILE. DAT 


Creating a 


Terminal Queue 


$ SHOW DEVICE T 


$ SET TERMINAL - 
_$ /PERMANENT - 

_$ /NOTYPE_AHEAD - 
_$ /SPEED=2400 - 
_$ /NOBROADCAST - 
_$ TTA3 


$ SET DEVICE - 
_§ /SPOOLED=WORK1 - 
_$ TTA3 


$ INITIALIZE/QUEUE — 
_$ /TERMINAL - 

_§$ /START/ON=TTA3 - 
_$ LINE_PRINTER 


$ SHOW QUEUE/ALL - 
_$ /DEVICE 


$ PRINT FILE.DAT 


Comments 


Lists the devices and selects 
one. 


Sets the attributes of the 
printer or terminal to match 
its physical attributes or to 
force the printer to produce 
specific output. (For example, 
/UPPER causes ail jobs to 
be printed in uppercase.) 
Terminals must have certain 
attributes set as shown. 
(Speed should be specified to 
match the terminal speed.) 


Enables COPY commands 
and write statements for that 
device; you can specify an 
intermediate device or use 
the current default device 
(SYS$DISk). 


Assigns the queue a different 
name than its device name 

if desired by using the /ON 
qualifier. (By default, the 
name of the queue matches 
the name of the printer.) 


Displays all execution 
queues. 


Since the PRINT command 
sends files to the SYS$PRINT 
queue by default, and the 
name of the print execution 
queue for the LPAO printer 

is SYS$PRINT, the first 
command prints FILE.DAT on 
LPAO. The second command 
is similar, but the SYS$PRINT 
queue is defined to print on 
TTAS. 
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Creating Generic Print Queues 


Establish generic print queues when you have more than one printer set up in the same fashion, 
and want to share the processing among the printers. 


¢« The system does not move jobs from generic queues to execution queues initialized with 
/NOENABLE_GENERIC qualifier. 


¢ Execution queues are given the /ENABLE_GENERIC attribute by default. 


Table 3-3 shows the steps used in creating and using generic print queues. 


Table 3-3 Creating and Using Generic Print Queues 


Operation Command Comment 
Creates an execution $ SET PRINTER/UPPER LPAO For example, the printer device 
queue for a printer $ SET DEVICE/SPOOLED LPAO LPAO 

$ INITIALIZE/QUEUE/START - 

_$ LPAO 
Creates an execution $ SET PRINTER/UPPER LPBO For example, the printer device 
queue for another printer $ SET DEVICE/SPOOLED LPBO LPBO 

$ INITIALIZE/QUEUE/START - 

_$ LPBO 
Creates a generic print $ INITIALIZE/QUEUE/START - — This queue receives default 
queue _$ /GENERIC SYS$PRINT print jobs and dispense them to 


any execution print queues that 
do not use the /NOENABLE _ 
GENERIC qualifier. 


Creates a generic print $ INITIALIZE/QUEUE/START - This queue receives default print 
queue with specific _$ /GENERIC=(LPAO,LPBO) - jobs and dispense them to LPAQO 
execution queues _$ SYSSPRINT or LPBO. | 

Uses the generic print $ PRINT FILE.DAT SYS$PRINT is the default queue 
queue for the PRINT command. In 


this example, SYS$PRINT is a 
generic print queue. The file is 
printed on LPAO if it is available. 
If LPAO is not available, and 
LPBO is available, the file is 
printed on LPBO. 
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Example 3-3 shows queue status display of current, pending, and holding jobs. 


Example 3-3 Queue Status Display of Current, Pending, and Holding Jobs 


$ SHOW QUEUE/DEVICE/GENERIC 


Generic 


Entry 


queue AFTERS, 


assigned to LPCO 


Jobname Username 
LATER JONES 
queue FORM3, stopped 
Jobname Username 
MATH JONES 
TEST JONES 
queue LPAO 

Jobname Username 
MEMO JONES 
queue LPBO 

Jobname Username 
ACTION JONES 
TABLES JONES 
queue LPCO 

Jobname Username 
FORTEST JONES 
queue OVERNIGHT, stopped 
Jobname Username 
LONG JONES 
BIGJOB JONES 


printer queue SYSSPRINT 


Jobname Username 
MEMO JONES 
printer queue TERM, 
Jobname Username 
PROG JONES 
NOTES JONES 


on TTA3: 


Blocks 


Blocks 


Blocks 


Status 


Pending 


Status 


Pending 
Pending 


Status 


Printing 


Status 


Printing 
Pending 


Status 


Printing 


Status 


Pending 
Pending 


Status 


Pending 


Status 


Printing 
Pending 
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Automatic Queue Creation 


To invoke automatic queue creation at boot time: 


Include queue commands in the startup command procedure to start queues at system 


startup. 


It is better to include a line in the startup command procedure to invoke a separate 


command procedure to start up queues. 


System shutdown procedure stops all queues (SYS$SYSTEM:SHUTDOWN.COM). 


Example 3-4 illustrates startup commands in SYSTARTUP_V5.COM. 


Example 3-4 Startup Commands in SYSTARTUP_V5.COM 


MMM MNAMANDNNNNNNANUMMUNUNN 


SET NOON 

! 

! Define and start up printer queues 

! 

SET PRINTER/LOWER LPAO 

SET DEVICE/SPOOLED LPAO 

INITIALI ZE/QUEUE/START/DEFAULT= (BURST, FLAG) 
! 


SET PRINTER/LOWER LPBO 

SET DEVICE/SPOOLED LPBO 
INITIALIZE/QUEUE/START LPBO 
' 


SET PRINTER/LOWER LPCO 

SET DEVICE/SPOOLED LPCO 
INITIALIZE/QUEUE/NOENABLE GENERIC LPCO 
1 


! Define and start up a generic print queue 
{ 


INITIALIZE/QUEUE/GENERIC/START SYSSPRINT 


3-18 Queue Management 


LPAO 


Monitoring Print Queues and Jobs 


You can monitor the status of print queues. The amount of information displayed depends on 
your privileges and queue ownership rights. 


Monitoring Print Queues 


¢« Use the SHOW QUEUE command to monitor an entire queue: 


$ SHOW QUEUE [/qualifiers] [queue-name] 
$ SHOW QUEUE/SUMMARY /DEVICE= (PRINTER, TERMI NAL) 


¢ Default action is to display status of all queues and all jobs owned by you. 
* Queues are displayed in alphabetical order. 
* Qualifiers provide selection of the type and amount of queue information to be displayed. 


* Queue status codes indicate current state of the queue (see Table 3-6). 
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The SHOW QUEUE qualifiers allow you to select the type of queue information you want to 
display (see Table 3—4), or the amount of information you want to display (see Table 3—5). 


Table 3-4 SHOW QUEUE Qualifiers for Displaying Types of Queues 


Qualifier 


/BY_ JOB STATUS=status-type 


/BATCH 


/DEVICE=keyword-list 


/GENERIC 


Description 


Displays queues that contain jobs of a specified type 

of status. If no keyword is specified, the jobs of all 
status-types are displayed. The types are EXECUTING, 
HOLDING, PENDING, RETAINED, and TIMED _RELEASE. 


Displays the status of batch execution queues. 


Displays particular type of queue: PRINTER, SERVER, or 
TERMINAL. If no keywords are specified, all types of output 
queues are displayed. 


Displays the status of generic queues. 


Table 3-5 SHOW QUEUE Qualifiers for Displaying the Amount of Queue Information 


Qualifier 


/ALL_JOBS or 
/ALL_ENTRIES 


/BRIEF 


/FILES 


/FULL 


/ SUMMARY 
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Description 


Displays information about all jobs or entries for the 
selected queue. 


Displays a brief listing of information about job entries in the 
queue. The brief listing is the default when no qualifier is 
specified with the SHOW QUEUE command. 


Adds the list of files associated with each job to the display. 


Displays complete queue and job information, including any 
ACLs set for the queue. 


Displays the total number of executing, pending, holding, 
retained, and time-released jobs. 


Table 3-6 shows queue status codes. 


Table 3-6 Queue Status Codes 


Status Code 


Aligning 


Device unavailable 
Operator service 
Pausing 

Paused 


Resuming 


Resetting 


Stalled 


Starting 


Stop pending 


Stopped 


Stopping 


Description 


The queue manager is processing a START/QUEUE/ALIGN 
command. 


Device to which the print symbiont is assigned is not available. 
A PRINT/OPERATOR command has been executed. 

The queue manager is processing a STOP/QUEUE command. 
A STOP/QUEUE command has been executed. 


The queue manager is processing a START/QUEVUE command on a 
paused queue. 


The queue manager is processing a STOP/QUEUE/RESET 


command. 


Print symbiont processing is temporarily halted due to a device-related 
problem. 


Queue has been started, but the print symbiont process is not yet 
active. 


Queue will be stopped when current jobs have finished executing. 


A STOP/QUEUE command specified with either a /NEXT, REQUEUE, 
or RESET qualifier has been executed. 


The queue manager is processing a STOP/QUEUE command 
specified with either a /NEXT, REQUEUE, or RESET qualifier. 
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Monitoring Print Jobs 


ee 


Use the SHOW ENTRY command to monitor individual jobs: 


$ SHOW ENTRY [/qualifiers] [entry-number or job-name] 


$ SHOW ENTRY 228 
$ SHOW ENTRY ACTION 
$ SHOW ENTRY/USER=JONES 


Most SHOW QUEUE qualifiers can be used to select the type and amount of queue information 


to be monitored. 


Queue status codes indicate current state of the job. 


Table 3-7 lists common job status codes. 


Table 3-7 Job Status Codes 


Status Code 
Aborting 
Executing 
Holding 

Holding until 
Pending 

Printing 
Processing 
Retained on completion 
Retained on error 
Stalled 


Waiting 
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Description 


Executing job is terminating. 

Job is executing from a batch queue. 

Job is being held until explicitly released. 

Job is being held until a specified time. 

Job is in a wait state, typically waiting to be processed. 
Job is executing from a printer or terminal execution queue. 
Job is executing from a server queue. 

Job remains in the queue upon completion. 

Job remains in the queue upon encountering an error. 
Job is executing on a print queue that is stalled. 
Symbiont refuses the job. 


Setting Print Queue Attributes 

The VMS system assigns certain default attributes to each queue when you create it, such as: 
¢ Owner (defaults to the user of the process creating the queue) 

« Base priority 

¢ Printer form definition 


« Protection code 


You can override these default attributes by defining different values for them when you create 
the queue. You can also define values for other attributes such as: 


« Number of separation pages for print jobs 
¢ Maximum and minimum allowed sizes of print jobs 


« Printer characteristics 


See Table 3—8 for details on when to use the proper command to specify or modify a queue’s 
attributes. Example 3-5 illustrates a situation where a queue is modified while running. 


Table 3-8 Commands to Modify Queue Attributes at Certain Times 


Command When to Use 

INITIALI ZE/QUEUE When the queue is being created (does not currently exist). 
SET QUEUE After the queue has been created, but is currently stopped. 
START / QUEUE 

INITIALIZE/ QUEUE 

SET QUEUE When the queue exists and is currently running. 


Not all parameters can be changed while the queue is running. 
See the output from HELP SET QUEUE for a list of parameters 
that can be changed. 
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Example 3-5 shows how to modify a running queue. 
Example 3-5 Modifying a Running Queue 


$ SHOW QUEUE/FULL LPAO 

Printer queue LPAO 
/BASE_ PRIORITY=4 /FORM=DEFAULT Lowercase /OWNER=[SYSTEM] 
/PROTECTION= (S:E,0:D,G:R,W:W) 

$ 

$ SET QUEUE/SEPARATE=(BURST, TRAILER) LPAO 

$ 

S$ SHOW QUEUE/FULL LPAO 

Printer queue LPAO 
/BASE_PRIORITY=4 /FORM=DEFAULT Lowercase /OWNER=[SYSTEM] 
/PROTECTION=(S:E,0:D,G:R,W:W) /SEPARATION=(BURST, TRAILER) 

$ 

$ PRINT/HEADER MEMO.TXT 

Job MEMO (queue SYSSPRINT, entry 349) started on SYSSPRINT 

$ 
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Specifying Separation Pages 

Separation pages are used to delineate between individual jobs and files within jobs. 

¢« Job separation pages 

« File separation pages 

Defaults can be set for separation pages on a queue (system default is no Separation pages). 
Separation page attributes can be viewed with SHOW QUEUE/FULL (See Example 3-6). 
Example 3-6 SHOW QUEUE — Job and File Separation Page Defaults 


$ SHOW QUEUE/FULL LPCO 

Printer queue LPCO 
/BASE PRIORITY=4 /DEFAULT= (FLAG) 
/FORM=DEFAULT Lowercase /OWNER=[SYSTEM] /PROTECTION=(S:E,0:D,G:R,W:W) 
/SEPARATE= (BURST, FLAG, TRAILER) 


- Use /SEPARATE=option for job separation pages (See Table 3-9). 
« Use /DEFAULT=option for file separation pages 
¢ Users can override defaults set for file separation pages 


« Users cannot override defaults set for job separation pages 
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Print Order of Pages 

The order of finited pages Wiel all file and job separation page defaults are set is: 
1. File burst page (/DEFAULT=BURST) 

File flag page (/DEFAULT=FLAG) (See Figure 3-1) 

File contents are printed 

File trailer page (/DEFAULT=TRAILER) (See Figure 3-2) 

Job burst page (/(SEPARATE=BURST) 

Job flag page (/SEPARATE=FLAG) (See Figure 3-3) 


System repeats previous four steps until all files in job are printed 


Se oe a ee ee 


Job trailer page ((SEPARATE=TRAILER) (See Figure 3—4) 
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Table 3-9 lists separation page options for the /SEPARATE qualifier. 


Table 3-9 Job Separation Page Options for the /SEPARATE Qualifier 


Option 


[NO] BURST 


[NO] FLAG 


[NO] TRAILER 


Description 


Specifies a copy of the flag page printed in such a way as to 
overprint the perforation between the preceding flag page. This 
makes it possible to determine job breaks in a stack of paper when 
viewed from the edge side of the paper. Note that if you specify a 
burst separation page, you do not need to specify a flag page, as 
it is printed automatically with the burst page. 


Specifies that a page is printed preceding the job with the name of 
the user printed in large letters. 


Specifies that a single summary sheet is printed following a job, 
with the name of the user printed in large letters. 


Table 3-10 lists separation page options for the /DEFAULT qualifier. 


Table 3-10 File Separation Page Options for the /DEFAULT Qualifier 


Option 


[NO] BURST [=keyword] 


[NO] FLAG [=keyword] 


[NO] TRAILER [=keyword] 


Description 


Specifies whether file burst pages are printed. If the keyword is 
ALL (the default), a burst page is placed before each file in the 
print job. If the Keyword is ONE, a burst page is placed before the 
first copy of the first file in the job. Note that if you specify a burst 
separation page, you do not need to specify a flag page, as it is 
printed automatically with the burst page. 


Specifies whether file flag pages are printed. If the keyword is ALL 
(the default), a flag page is placed before each file in the print job. 
If the keyword is ONE, a flag page is placed before the first copy 
of the first file in the job. ; 


Specifies whether file trailer pages are printed. If the keyword is 
ALL (the default), a trailer page is placed at the end of each file in 
the print job. If the keyword is ONE, a trailer page is placed after 
the last copy of the last file in the job. 
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File ee burst and ee pages, specified with the /DEFAULT=BURST qualifier, are shown 
in Figure 3-1. 


Figure 3-1 File Separation Burst and Flag Pages 
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A file separation trailer page, specified with the /DEFAULT=TRAILER qualifier, is shown in 
Figure 3-2. | 


Figure 3-2 File Separation Trailer Page 
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shown in Figure 3-3. 
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Job separation burst and flag pages, specified with the /SEPARATE=BURST qualifier, are 
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Figure 3-3 Job Separation Burst and Flag Pages 
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A file separation trailer page, specified with the /SEPARATE=TRAILER qualifier, is shown in 


Figure 3—4. 


Figure 3-4 Job Separation Trailer Page 
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Preventing Jobs from Being Entered in a Queue 
Use SET QUEUE/CLOSE to prevent jobs from being entered in a queue. 
Use SET QUEUE/OPEN to allow jobs to be entered in a queue. 


Moving Jobs from One Queue to Another 

¢« Stop a queue with STOP/QUEUE/NEXT before moving jobs so that no more jobs will be 
executed. 

¢ Requeue the current job if the queue is an execution queue. 


¢ Use SET QUEUE/CLOSE to keep additional jobs from being entered in the queue, if 
desired. 


Example 3-7 shows commands used to move jobs from one queue to another. 


Example 3~7 Moving Jobs from One Queue to Another 


$ STOP/QUEUE LPAO 
$ STOP/QUEUE/REQUEUE=LPBO LPAO 
S$ ASSIGN/MERGE LPBO LPAO 
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Deleting a Queue 
You must use STOP/QUEUE/NEXT before deleting a queue with DELETE/QUEUE. 
Example 3-8 shows how to delete a queue. 


Example 3-8 Deleting a Queue 


$ STOP/QUEUE/NEXT LPAO 
$ DELETE/QUEUE LPAO 


Deleting Jobs in Queues 

You can delete jobs using DELETE/ENTRY when: 

¢ A queue is running or when a queue is stopped 
* Restarting a queue 

Example 3-9 shows how to delete jobs in queues. 


Example 3-9 Deleting Jobs in Queues 


$ DELETE/ENTRY=715 
$ DELETE/ENTRY= (821, 823, 824) 


Queue Management 3-33 


Handling Print Queue Problems 


Problems can arise with printers: 


¢ Paper jams 


¢ Paper runs out 


¢ Ribbon tears or poor print density 


You might have to reprint part or all of any job that was printing when such a problem occurs. 
The commands needed to reprint problem jobs can also be used to set up a printer for repetitive 


or sequential print situations. 


Use positioning and alignment qualifiers to handle these situations as illustrated in Table 3-11 


and Table 3-12. 


Table 3-11 Positioning a Print Job 


Qualifier to START/QUEUE 
/BACKWARD=n 
/FORWARD=n 


/SEARCH=st ring 


/TOP_OF_ FILE 


Comments | 
File is backspaced n pages before printing is resumed. 
File is forward spaced n pages before printing is resumed. 


Resumes printing with page containing string. (Search 
direction is forward. Other qualifiers processed first.) 


Printing begins at top of interrupted file (not top of job). 


Table 3-12 Aligning Printer Paper 


Command Format/Examples 
S$ START/QUEUE/ALIGN - 
_$ queue-name 


$ START/QUEUE/BACKWARD=2 - 
_$ /ALIGN=2 LPAO 
$ START/QUEUE LPAO 
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Comments 


One page of the job is printed. The queue stops. Aolust 
the paper and restart the queue. 


You can back up several pages before beginning the 
reprint. In this example, the symbiont backs up two pages 
in the job, then prints two alignment pages and stops. 
The user adjusts the paper and restarts the queue. The 
system begins printing the next page in the job. 


HOW THE VMS SYSTEM HANDLES BATCH JOBS 


When you execute a command procedure in your interactive process, you cannot enter any 
other commands until the procedure completes. This may be acceptable if you do not mind 
waiting or if there is another terminal available for you to use. However, most users have 
access to only one terminal at a time. 


Batch queues make waiting unnecessary and allow best use of terminals and other resources. 
The SUBMIT command places a batch job in a batch queue. 


¢ Batch queues must exist for the VMS system to execute batch jobs. 


The QUEUE_MANAGER process schedules batch jobs to execute, and the JOB CONTROL 
process creates a batch process in which to execute each job. 


¢ Name of process composed of word BATCH and job’s queue entry number 
¢ Jobs listed in queue as currently executing 


* Batch process appears in SHOW SYSTEM display with B in the rightmost column 


Example 3-10 JOB CONTROL and Batch Job Processes 


$ SHOW SYSTEM 
VAX/VMS V5.5 on node BIMBAM 14-NOV-1991 17:21:45.54 Uptime 21 09:23:21 


Pid Process Name State Pri I/O CPU Page flts Ph.Mem 
20200021 SWAPPER HIB 16 0 0 00:00:21.96 0 0 
202002A2 Chocoholic HIB 9 4000 0 00:01:00.00 6658 328 
20200263 DUFFY LEF 4 328 0 00:00:10.49 L057 299 
20200027 ERRFMT HIB 8 9995 0 00:02:59.54 82 118 
20200028 CACHE SERVER HIB 16 152 0 00:00:00.75 62 93 
20200029 CLUSTER SERVER HIB 8 39 0 00:00:02.20 -151 314 
2020002A OPCOM HIB 8 4321 O 00202213 276 645 211 

@ 20200138 BATCH 103 CUR 3 80 0 00:00:02.93 588 259 B @ 
2020002B AUDIT SERVER HIB 10 54 0 00:00:54.84 1300 223 

@ 2020002c JOB_CONTROL HIB 9 1875 0 00:00:14.57 207 412 
2020002D CONFIGURE HIB 10 122 0 00:00:12.96 111 159 
2020002E SMISERVER HIB 9 104 0 00:00:03.07 406 437 
20200251 NETACP HIB 10 1493 0. 01:24:58.28 2321834 3500 
20200112 EVL ’ HIB 5 1390 0 00:00:39.21 49642 38 N 
202001B3 REMACP HIB 9 59 0 00:00:00.56 80 50 
20200075 WOODS LEF 4 14551 0 00:09:09.52 37853 170 
20200079 RTAI: HIB 6 22780 0 00:20:36.65 10459 4096 


Notes on Example 3—10: 
@ Batch process 
@ The letter B indicates that this process is executing a batch job 


© The JOB_CONTROL process 
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Example 3-11 lists current and pending jobs on a batch queue. 


Example 3-11 Current and Pending Jobs on a Batch Queue 


$ SHOW QUEUE/FULL SYSSBATCH 
Batch queue SYSSBATCH 
/BASE PRIORITY=3 /JOB_LIMIT=2 /OWNER=[SYSTEM] /PROTECTION=(S:E,0:D,G:R,W:W) 


Entry Jobname Username Status 


223 ACTION JONES Executing 
Submitted 13-DEC-1991 12:44 /PRIORITY=100 
_DJAO: [JONES] ACTION.COM;2 (executing) 


230 MATH JONES Executing 
Submitted 13-~DEC-1991 12:57 /PRIORITY=100 
_DJAO: [JONES]MATH.COM;1 (executing) 


237 COMPUTE JONES Pending 
Submitted 13-DEC-1991 13:41 /PRIORITY=120 
_DJAO: [JONES] COMPUTE.COM;7 (pending) 


236 ACTION JONES Pending 
Submitted 13-DEC-1991 13:10 /PRIORITY=100 
_DJAO: [JONES] ACTION.COM;3 (pending) 


$ 
Notes on Example 3-11: 


@ Jobs 223 and 230 are currently executing. The JOB_LIMIT attribute of the queue has 
a value of 2, limiting the number of concurrent batch processes from this queue to 2. 
Because the number of concurrent batch processes running from SYS$BATCH equals 
its job limit, Job 236 and Job 237 must wait to execute. Their status is pending. The 
QUEUE_MANAGER process examines the parameters of the pending jobs to determine 
which job to execute next. 


@ Since Job 237 has a higher queue priority than Job 236, (see note 2 of Example 3-2) it will 
execute next. 


NOTE 


Although the queue priority of a batch job helps to determine when it 
is scheduled, the queue priority does not affect the base priority of the 
batch process. The base priority of batch processes is defined by: 


e The value of the BASE_PRIORITY queue attribute; in this case, 3. 


e The value of the system parameter DEFPRI. The system uses this 
value if you do not set the BASE_PRIORITY attribute for a queue. 


© Finally, Job 236 will execute. However, if a user submits another job before Job 236 begins 


executing, the QUEUE_MANAGER process compares the parameters of the new job with 
those of Job 236 to determine which job to execute next. 
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BATCH QUEUE OPERATIONS 


Operations on batch queues are very similar to those performed on print queues. Almost 
everything presented on print queues pertains to batch queues, except such print-specific 
situations as separation pages, printer forms, and job positioning commands. 


Two functional areas that differ slightly from print queues are: 
*« Creating batch queues 


¢ Stopping batch queues 


Creating Batch Queues 

To create the default batch queue SYS$BATCH: 
$ INITIALIZE/QUEUE/BATCH/START SYSSBATCH 

* Default queue for SUBMIT command 


¢ Default queue for spooled jobs from card readers 


You must create all batch queues (none are automatically created). 


Table 3-13 lists sample batch queues and parameter values. Table 3-14 shows initialization of 


batch queues. 
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Table 3-13 Batch Queue Names and Parameter Values 





Suggested Name 
and 

Purpose of the 
Queue 


GROUP360 

Used by those whose 
group UIC is 360 
because they are 
working on a high-priority 
project. 


FASTQUE 
Used by all who need a 
job done quickly. 


SLOWQUE 

Used by all who want 
to run a batch job 

that affects system 
performance as little as 
possible. 


ZOOMQUE 

Very fast queue that you 
only start after hours or 
during lunch. 


CADCAM 

Used by large, compute- 
intensive applications, 
such as engineering, 
manufacturing, or 
modeling programs. 


Parameters and Comments 


Sets the owner UIC of the queue to [360,000]. Gives GROUP users READ and WRITE 
access only. Gives WORLD users no access. Sets larger working set extent, CPU limits, and 
priority. Possibly increases the job limit. 


Sets the base priority at 5. Uses default queue protection or possibly restricts use to a certain 
group, UIC, or ACL. Sets job limit at 2, but limits the maximum CPU to a low value to keep 
the queue from taking over the system. Optionally uses higher working set limits. 


Sets the priority at 3. DO NOT set to 0 or 1, as jobs may get very little CPU time and finish 
too slowly. Uses default queue protection. Sets job limit to 1. Uses default working set limits. 


Sets the base priority at 6 or higher, but definitely sets a low CPU limit. Uses default queue 
protection. Sets job limit to 2. Sets high working set limits. You should note, however, 

that setting a batch queue’s default BASE_PRIORITY to a value higher than the normal 
interactive value is generally considered somewhat dangerous to system response time. You 
should carefully monitor any batch queue running in this fashion to avoid system degradation. 


Sets up as shown with SLOWQUE, but increases working set limits to large values. Sets 
CPU limit to very large value, or infinite. Optionally protects the queue for access by only 
specific user groups. 
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Table 3-14. Qualifiers to INITIALIZE/QUEUE for Batch Queues 


Qualifiers Examples 


/JOB_LIMIT $ INITIALIZE/QUEUE/BATCH - 
_$ /JOB_LIMIT=2 FASTBAT 


/BASE_PRIORITY $ INITIALIZE/QUEUE/BATCH — 
_$ /BASE_PRIO=5 FASTBAT 


/PROTECTION $ INITIALIZE/QUEUE/BATCH - 
/OWNER_UIC _$ /OWNER=[ENG, PROJ5] - 
_$ /PROT=(S:E,0:D,G:R,W:W) 
/WSDEFAULT $ INITIALIZE/QUEUE/BATCH - 
IWSQUOTA _$ /WSDEFAULT=500 - 
/WSEXTENT _$ /WSQUOTA=800 - 
/DISABLE _ _$ /WSEXTENT=2000 - 
SWAPPING _$ /DISABLE SWAPPING - 
_$ FASTBAT 
/CPUMAXIMUM $ INITIALIZE/QUEUE/BATCH - 


_$ /CPUMAXIMUM=INFINITE - 
_S BIGJOBBAT 


/CPUDEFAULT $ INITIALIZE/QUEUE/BATCH - 
_$ /CPUDEFAULT=00:03:00 - 
_$ 3MINBAT 


Comments 


Sets a limit on the number of batch 
processes that can run concurrently 
from one batch queue. The default 
is 1. | 

Defines the base priority of a batch 
process. The system parameter 
DEFPRI sets the default. The 
higher the priority, the sooner 

it is scheduled to run. If many 
batch processes have priorities as 
high as, or higher than, interactive 
process priorities (default 4), they 
can degrade the performance for 
interactive users and the whole 
system. 


Limits access to a queue. 


Defines memory management 
parameters for the batch process 
(limits working set size and 
adjustment allowed; sets swap 

or noswap). UAF values are the 
default. If you set high values for 
these and disable swapping of 
processes for the queue, you can 
use sO much memory that system 
performance is degraded (because 
paging and swapping increases for 
interactive jobs). 


Sets the maximum CPU limit to be 
assigned to a batch process from 
the queue. The default maximum 
is the CPU limit in the owner’s UAF 
record. 


Sets default CPU limit assigned to 
batch processes from this queue. 
Otherwise, the default is the CPU 
limit in the user’s UAF record or 
the value of /CPUMAXIMUM for the 
queue. 
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Stopping Batch Queues 

To stop execution of the current job: 

$ STOP /QUEUE 

To complete current job before stopping queue: 
$ STOP /QUEUE/NEXT 

To stop a job executing in a queue: 


$ STOP/ENTRY=job number 
$ STOP/ENTRY=205 
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Example 3-12 shows how to stop batch queues. 


Example 3-12 Stopping Batch Queues 


@ $s SUBMIT ACTION.COM 


Job ACTION (queue SYSSBATCH, entry 911) 
$ 

S$ STOP/QUEUE SYSSBATCH 

$ 


$ SHOW QUEUE/ALL SYSSBATCH 
@ Batch queue SYSSBATCH, paused 


Username 


Entry Jobname 


911 ACTION 

$ 

S SHOW SYSTEM/BATCH 

VAX/VMS V5.5 on node BIMBAM 13-DEC-1991 
Pid Process Name State Pri 


© 202003c5 BATCH 911 SUSP 4 
$ 
@ s START/QUEUE SYSSBATCH 


$ 

© s sToP/QUEUE/NEXT SYSSBATCH 
$ 
$ SHOW QUEUVE/ALL SYSSBATCH 


@ Batch queue SYSSBATCH, stop pending 


Username 


Entry Jobname 


911 


ACTION 
$ 
$ SHOW SYSTEM/BATCH 
VAX/VMS V5.5 on node BIMBAM 13-DEC-1991 
Pid Process Name State Pri 
@ 202003C5 BATCH 911 LEF 4 
$ 
S$ SHOW QUEUE/ALL SYSSBATCH 
@ Batch queue SYSSBATCH, stopped 
$ 
@ s sHOW SYSTEM/BATCH 
$ 


started on SYSSBATCH 


Status 


Executing 


13330824238 Uptime 12223302594 

I/O CPU Page flts Ph.Mem 

25 0 00:00:00.71 143 171 B 
Status 
Executing 


13:31:46.62 Uptime 12 22:31:33 
I/O CPU Page flts Ph.Mem 
25 0 00:00:00.71 143 171 B 
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Notes on Example 3-12: 


® 6 08 9 


The command file ACTION.COM is submitted and placed into the default system batch 
queue, SYS$BATCH, since an explicit /QUEUE qualifier was not specified in the command. 
The queue manager assigned the entry number of 911 to the queue request. 


Examining the queue shows its state is paused, but the state of the batch job is Executing. 
Note the system indicates the executing batch job as being in a suspended (SUSP) state. 
Starts the SYS$BATCH batch queue running again. 


Informs the queue manager to stop the SYS$BATCH queue after the current batch job is 
finished executing. 


The current batch job continues executing, but the SYS$BATCH queue state indicates a 
pending stop on the queue. New jobs can be entered into the queue, but they remain ina 
pending state until the queue is restarted. 


Note the system indicates the current batch job is running and is in a Local Event Flag 
(LEF) wait state. 


Now we see the SYS$BATCH queue in a stopped state and that there are no jobs 
executing or awaiting execution. 


The system indicates no batch jobs are currently executing. 
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MANAGING BATCH AND PRINT OPERATIONS IN A 
VAXcluster SYSTEM 


Distributed Queuing 


The job controller and queue manager distribute the batch and print processing workload over 
cluster members: 


¢ Permit users to submit batch and print jobs to queues that execute on any node in the 
cluster 


* Use a common queue database to maintain the current state of all queues on all systems 
on the cluster 


« Allow generic queues to be created that feed execution queues on any systems in the 
cluster 


* Direct batch and print jobs to the execution queue with the lowest ratio of jobs to queue 
limit (or to the next available queue) 


¢ Use the distributed lock manager to signal other members to examine the batch and print 
queues for jobs to be processed 
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Setting Up Cluster-Wide Queues 


* Queue database stores cluster-wide queue information on a cluster-available disk. 


* You must make queue names unique to avoid conflicts in the cluster-wide queue database. 


Setting Up Cluster-Wide Batch and Print Queues 


* — Initialize queues from each node where they will be used 
¢ Start each queue on the node where its print or CPU resource is located 


¢ Include the /ON=resource_name qualifier to specify the exact name of the printer or CPU 
as needed 


¢ Resource_name is of the form: 
— node:: for a batch queue 


— node::device: for a print queue 
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Examples of Creating Ciuster-Wide Generic Print and Batch Queues 


Example 3-13 Queue Creation Commands on BARNUM 


INITIALIZE/QUEUE/ON=BARNUM: : LPAO: /START BARNUM PRINT 
INITIALIZE/QUEUE/ON=BAILEY: : LPAO: BAILEY PRINT 
INITIALIZE/QUEUE/GENERIC=(BARNUM PRINT,BAILEY PRINT) - 
/START CLUSTER_PRINT 

$ DEFINE/SYSTEM SYSSPRINT CLUSTER_PRINT 


MmOaD 


Example 3-14 Queue Creation Commands on BAILEY 


INITIALIZE/QUEUVE/ON=BARNUM: : LPAO: BARNUM_ PRINT 

INITIALIZE/QUEUE/ON=BAILEY::LPA0O:/START BAILEY PRINT 

INITIALIZE/QUEUE/GENERIC=(BARNUM_PRINT,BAILEY PRINT) - 
/START CLUSTER_PRINT 

$ DEFINE/SYSTEM SYSSPRINT CLUSTER PRINT 


NM WwW 


Example 3-15 Queue Creation Commands on All Other Cluster Members 


$ INITIALIZE/QUEUVE/ON=BARNUM: : LPAO: BARNUM_ PRINT 
$ INITIALIZE/QUEUE/ON=BAILEY::LPAO: BAILEY PRINT 
$ INITIALIZE/QUEUE/GENERIC=(BARNUM PRINT,BAILEY PRINT) - 


/START CLUSTER_PRINT 
$ DEFINE/SYSTEM SYSSPRINT CLUSTER_PRINT 


Example 3-16 SHOW QUEUE Output on Any Cluster Member 


$ SHOW QUEUE/DEVICE/FULL 

Printer queue BARNUM PRINT, on BARNUM::LPAO: 
/BASE_PRIORITY=4 /DEFAULT=(FEED) /FORM=DEFAULT 
/OWNER=[SYSTEM] /PROTECTION=(S:E,0:D,G:R,W:W) 


Printer queue BAILEY PRINT, on BAILEY: :LPAO: 
/BASE_PRIORITY=4 /DEFAULT=(FEED) /FORM=DEFAULT 
/OWNER=[SYSTEM] /PROTECTION=(S:E,0:D,G:R,W:W) 


Generic printer queue CLUSTER PRINT 
/GENERIC=(BARNUM PRINT,BAILEY PRINT) /OWNER=[SYSTEM] 
/PROTECTION=(S:E,0:D,G:R,W:W) 


Queue Management 3-45 


Creating a Cluster-Wide Generic Batch Queue 


Example 3-17 Creating and Displaying Cluster-Wide Batch Queues 


On LION: 

$ INITIALIZE/QUEUE/BATCH/ON=LION::/START LION BATCH 

$ INITIALIZE/QUEUE/BATCH/ON=TIGER: : TIGER BATCH 

$ INITIALIZE/QUEUE/BATCH/ON=BEAR:: BEAR_BATCH 

$ INITIALIZE/QUEUE/BATCH/ON=HORSE: : HORSE_BATCH 

$ INITIALIZE/QUEUE/BATCH/ON=BARNUM: : BARNUM_ BATCH 

$ INITIALIZE/QUEUE/BATCH/ON=RNGLNG: : RNGLNG BATCH 

$ INITIALIZE/QUEUE/BATCH/ON=BAILEY:: BATLEY BATCH 

$ INITIALIZE/QUEUE/BATCH/GENERIC=(LION BATCH, TIGER BATCH, BEAR BATCH, - 
HORSE_BATCH, BARNUM_BATCH,RNGLNG BATCH, BAILEY BATCH)/START SYS$BATCH 

On BAILEY: 

$ INITIALIZE/QUEUE/BATCH/ON=LION:: LION BATCH 

$ INITIALIZE/QUEUE/BATCH/ON=TIGER: : TIGER BATCH 

$ INITIALIZE/QUEUE/BATCH /ON=BEAR: : BEAR BATCH 

$ INITIALIZE/QUEUE/BATCH/ON=HORSE: : HORSE_BATCH 

$ INITIALIZE/QUEUE/BATCH/ON=BARNUM: : BARNUM_ BATCH 

S$ INITIALIZE/QUEUE/BATCH/ON=RNGLNG:: RNGLNG_ BATCH 

$ INITIALIZE/QUEUE/BATCH/ON=BAILEY::/START BAILEY BATCH 

$ INITIALIZE/QUEUE/BATCH/GENERIC=(LION BATCH, TIGER BATCH,BEAR BATCH, - 


HORSE_BATCH, BARNUM BATCH,RNGLNG BATCH, BAILEY BATCH) /START SYSSBATCH 


On any cluster member: 


$ SHOW QUEUE/BATCH/FULL 

Batch queue HORSE BATCH, on HORSE:: 
/BASE_PRIORITY=4 /JOB LIMIT=1 /OWNER=[SYSTEM] 
/PROTECTION=(S:E,0:D,G:R,W:W) 


Batch queue BAILEY BATCH, on BAILEY:: 
/BASE PRIORITY=4 /JOB LIMIT=1 /OWNER=[SYSTEM] 
/PROTECTION=(S:E,0:D,G:R,W:W) 


Generic batch queue SYSSBATCH 

/GENERIC=(LION_BATCH, TIGER_BATCH,BEAR_ BATCH, 

HORSE BATCH, BARNUM_BATCH,RNGLNG BATCH, BAILEY BATCH) 
/OWNER=[SYSTEM] /PROTECTION=(S:E,0:D,G:R,W:W) 
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Common Queue Startup 


Example 3-18 Common Command Procedure for Queue Startup 


et mee DU TD OD OU ee ee Ye ee ee DD ee NUN WWM Me 2 ee DH 


SET NOON 
STARTQUE.COM for all nodes 


Initialize Symbols 

LION _START="/NOSTART" 
TIGER_START="/NOSTART" 
BEAR_START="/NOSTART" 
HORSE_START="/NOSTART" 
BARNUM_START="/NOSTART" 
RNGLNG_START="/NOSTART" 
BAILEY START="/NOSTART" 


Set symbol for this member 

NODE = FSGETSYI ("NODENAME" } 

‘NODE’ START = "/START" 

Initialize and start cluster print queues. These are the only two members 


that have local printers. 


INIT/QUE/ON=BARNUM: : LPAO:’ BARNUM START BARNUM PRINT 
INIT/QUE/ON=BAILEY::LPAO:’BAILEY START BAILEY PRINT 


Initialize and start the cluster-wide generic print queue. All members in 
the cluster need to start this generic queue. 


INIT/QUE/GENERIC=(BARNUM_ PRINT,BAILEY PRINT) /START SYSSPRINT 


Initialize and start batch queues 
INITIALIZE/QUEUE/BATCH/ON=BARNUM: :’BARNUM START BARNUM_ BATCH 


INITIALIZE/QUEUE/BATCH/ON=LION: :’LION_ START LION BATCH 
INITIALIZE/QUEUE/BATCH/ON=TIGER: :’ TIGER_START TIGER_BATCH 
INITIALIZE/QUEUE/BATCH/ON=BEAR: :’BEAR START BEAR BATCH 


INITIALIZE/QUEUE/BATCH/ON=HORSE: :’HORSE_ START HORSE _ BATCH 
INITIALIZE/QUEUE/BATCH/ON=RNGLNG: :’RNGLNG START RNGLNG_ BATCH 
INITIALIZE/QUEUE/BATCH/ON=BAILEY::’BAILEY START BAILEY BATCH 


Initialize and start the cluster-wide generic batch queue. 


INITIALIZE/QUEUE/BATCH/GENERIC= (LION BATCH, TIGER_BATCH, BEAR_BATCH, - 
HORSE BATCH, BARNUM BATCH,RNGLNG BATCH, BAILEY BATCH)/START SYSSBATCH 
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SUMMARY 


There are two types of queues: 
¢« Execution 


« Generic 


Overview of Queue Commands 


Most queue commands require either OPER privilege or Execute (E) access to the target 


queue. 


Table 3-15 summarizes the various classes of DCL queue commands and their usage. 


Table 3-15 Summary of Queue-Related DCL Commands 


DCL Command 


Command Description 


Creating/Controlling/Deleting Queues 


INITIALIZE/QUEUE 
ASSIGN/QUEUE 
ASSIGN/MERGE 
START/ QUEUE 

STOP /QUEUE 
DEASSIGN/ QUEUE 


DELETE/QUEUE 


Creates and initializes a queue 
Assigns a queue to a device 

Moves jobs from one queue to another 
Starts or restarts a queue 

Controls queue or current entry in it 
Deassigns a queue from a device 
Deletes a queue and all its entries 


Setting Job Attributes 


PRINT 
SUBMIT 
SET ENTRY 


DELETE/ENTRY 


Monitoring Queue and Entry Status 
SHOW QUEUE 


SHOW ENTRY 


3-48 Queue Management 


Places an entry in a print queue 

Places an entry in a batch queue 

Changes the status of a pending entry in a queue 
Deletes a pending entry from a queue 


Displays status of entries in a queue 
Displays status of an individual job entry 


Performing Backups and Restores 


INTRODUCTION 


This chapter presents the basic concepts of performing backups and restores. Among the 
topics covered are: 


¢« The method used for making backup copies of system files 
« How to use command procedures for backups 
¢ How to restore files from backup copies 


* How to list the contents of a save set 
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OBJECTIVES 


To perform backups and seers: a system and network manager should be able to: 
- Make image and incremental backup copies of files 

« Use command procedures for backups 

¢ Restore files from Image and Incremental backup copies 


« List the contents of a save set 


RESOURCES 


« VMS DCL Dictionary 
¢ VMS System Manager's Manual 
* Guide to Setting Up a VMS System 


¢ Guide to Maintaining a VMS System 
TOPICS 


¢ Making backup copies of files 
¢« Using command procedures for backups 
« Restoring files from backup copies 


« Listing the contents of a save set 
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MAKING BACKUP COPIES OF FILES 


You should make backup copies of the files on your system on a regular and scheduled basis. 


There are two general types of backups that save copies of all of the files on your system: 


Image (full) backups 


Incremental backups 


Image and Incremental Backups 


You can make either image backups (also called full backups) or incremental backups. 


Image Backups—save a copy of all files 
— Easier and faster to restore than an incremental backup 


Incremental Backups—save a copy of those files that have been created or modified since 
the most recent backup 


— Useful only when an image backup using the /RECORD qualifier has previously been 
taken 


— Performed more quickly than image backups 
— Require less storage space 


Files that have been backed up with a combination of image and incremental backups are 
more complicated to restore than files that have been backed up in an image backup. 


If you choose to use incremental backup, remember that you must also make periodic 
image backups of your files. 


It might be reasonable to make an image backup weekly and to make daily incremental 
backups for disks where files are updated frequently. 


For small systems, it can be useful to use a batch job that backs up the entire system daily, 
resubmitting itself automatically. 


When you perform any type of backup, it is best to notify users using the REPLY/ALL 
command. An example of a backup notification using REPLY/ALL follows: 


$ REPLY/ALL "System Backup about to begin" 
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Save Sets 
When you back up files in a save operation, the files are stored in units called save sets. 


A save set is a file created and used by Backup when you use the BACKUP command to save 
files. 


The save set includes the files that you save with Backup and other information that is used by 
Backup. 


A save set can be: 
* A file on tape 
¢« A disk file on the local system 


* A disk file on another system in the network 


Using the BACKUP Command to Save Files 
The BACKUP command line has three key parts: 


$ BACKUP/qualifiers file _specification/qualifiers saveset_specification/qualifiers 


¢ BACKUP/qualifiers—The BACKUP command and its qualifiers 


¢  file_specification/qualifiers—gives information about the disk and files that currently exist 
and are to be backed up 


* saveset_specification/qualifiers—this part of the command line identifies the tape drive (or 
disk or diskette), optionally the node, and the save-set name to which files are to be copied 
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Making Image Backups of a Disk 
To make an image backup that copies all the files on a disk to a magnetic tape, do the following: 


¢- Use the BACKUP command with the /IMAGE and /RECORD qualifiers as the first part of 
the command line. 


— /IMAGE qualifier identifies the backup operation as an image backup 


— /RECORD qualifier provides information for BACKUP to use when subsequent backups 
are taken 


¢ Give the input device followed by a colon 


- As the third part of the command line, give the name of the output tape device, followed by 
a colon and the name of the save set you want to use. 


For example, suppose you want to save all the files on a disk named DRA1: to a magnetic 
tape on the device named MTAO:. 


The following command line creates a save set named 19JUNE1991.SAV on the tape that is in 
MTAO:, and that save set will contain all the files on DRA1:. Before the files are copied, the 
tape in MTAO: is rewound. | 


$ BACKUP/IMAGE/RECORD DRAI1: MTAO :19JUNE1991.SAV/REWIND 
With this command line, you initialize the tape (with the /REWIND qualifier), and the tape has 
a volume label of 19JUNE (the first six characters of the save set name). With this command, 


the backup facility also mounts the tape using the save set name that is generated as the label 
for the tape. 
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Example 4-1 Image Backup of a Disk 


ALLOCATE MUAO: 

INITIALIZE MUAO: IMAGE1 

MOUNT/FOREIGN MUAOQO: 

SHOW DEVICE/FILE $1$DUA3: 

DISMOUNT $1$DUA3: /NOUNLOAD 

MOUNT $1SDUA3: USERDISK 

BACKUP/IMAGE/RECORD $1S$DUA3: MUAO:PS_15AUG.BCK/REWIND/LABEL=IMAGE1 
DISMOUNT/NOUNLOAD $1SDUA3: 

MOUNT/SYSTEM $1SDUA3: USERDISK 


MAU UNUNUNUMNDN 


Example 4—1 shows an example of how you would do an image backup of the disk $1$DUA3:. 
Notes on Example 4—1: 

* IMAGE‘ is the label name for MUAO: 

¢ The first DISMOUNT command ensures that there is no disk activity 


¢ USERDISK is the label name for $1$DUAS: 
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Making Incremental Backups of a Disk 


Incremental backups save only files that have been created or modified since the last image or 
incremental backup in which the /RECORD qualifier was used. 


To make an incremental backup: 
* Use the /SINCE=BACKUP qualifier with the BACKUP command — 


« The syntax for incremental backups is the same for image backups except that you cannot 
use the IMAGE qualifier 


* You can specify files to be saved, and you can specify input-specifier qualifiers 


For example, suppose that you had used the command line shown in Making Image Backups 
of a Disk for an image backup, and you now wanted to make an incremental backup. 


The following command line makes an incremental backup, saving all files on DRA1: that were 
modified since the previous BACKUP/RECORD command, storing them in a save set named 
19JUNE1991.SAV: 


$ BACKUP/RECORD/SINCE=BACKUP DRA1:[*...] MTAO :19JUNE1991.SAV/LABEL=219JUNE 


When you initialize a tape, the tape is given a volume label, which is an identifier of one to six 
characters included as part of the header information on the tape. You can use the /LABEL= 
qualifier to choose a volume label of up to six characters; alternatively, the first six characters 
of the save set name are used to form the volume label if the /LABEL qualifier is not used. (For 
example, if your save set is named 20JUNE1991.SAVE, then the volume label is 20JUNE if 
you do not use the /LABEL qualifier.) Backup uses the volume label to ensure that you do not 
create a save set on the wrong magnetic tape, thus unintentionally overwriting existing data. 


Example 4-2 shows how you would do an incremental backup of $1$DUAS:. 


Example 4-2 Incremental Backup of a Disk 


$ ALLOCATE MUAO: 

$ INITIALIZE MUAO: MONDAY 

$ MOUNT/FOREIGN MUAO: 

$ BACKUP/SINCE=BACKUP/RECORD $1$DUA3:[*...]*.*;* - 
MUAO:DUA3_15AUG.BCK/REWIND/LABEL=MONDAY 
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USING COMMAND PROCEDURES FOR BACKUPS 


By using command procedures, you can be sure that your system backups take place when 
you want them to. The following sections give examples of command procedures for specific 
situations. These are merely examples of the various command procedures that can be used 
for backup, what you use quite naturally varies according to your users’ needs. 


Command Procedure for Nightly Image Backups 


The following command procedure performs nightly image backups, using disk DUAO:. This 
procedure executes nightly at 2:00 a.m. This procedure is only useful if your backup does not 
take more than one tape, otherwise someone needs to be present at 2:00 a.m. to change 
tapes. 


To use the following command procedure: 


1. Create the command procedure as shown in the SYS$MANAGER directory ([SYSMGR)), 
and call it SYSTEM_BACKUP.COM. Edit the command procedure to reflect the name of the 
disk or disks you want to back up, the name of the tape drive to use, and the name of the 
save set you want to assign. The example uses a save set named FULL_BACKUP.SAV. 


2. Write down the name of the save set that you assigned. 


3. Submit the command procedure using the following command line: 


$ SUBMIT /AFTER="TOMORROW+2:0" SYSSMANAGER: SYSTEM BACKUP 


4. Be sure that a tape is loaded on the specified device. When the backup is complete, keep 
the tape in a safe place and do not use it again until you make another image backup of 
your system. 


$! 
$! Resubmit this procedure -- 
$ SUBMIT/AFTER="TOMORROW+2:0" SYSSMANAGER: SYSTEM BACKUP 


$ SET NOON 

$ ON ERROR THEN GOTO DONE 

$ ON CONTROL Y THEN GOTO DONE 
$ SET PROC/PRIV=ALL 
$ 
$ 


REPLY/ALL - 
"Full System Backup About to Begin. Open Files Will Not Be Saved" 


$ BACKUP /IMAGE DUAO: MUAO:FULL BACKUP.SAV /REWIND 


S$ WRITE SYSSOUTPUT "---> Completed backup of DUAO save set" 
$ WRITE SYSSOUTPUT "" 

$! 

SDONE: 

$ DISMOUNT MUAO: 

$ EXIT 
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Command Procedure for Nightly Incremental Backup 


The following command procedure performs an incremental backup on three disks every other 
night at 11:00 p.m. 


1. Create the command procedure as shown, and call it INCREMENTAL_BACKUP.COM. Edit 
the procedure to reflect: 


The names of the disk or disks you are using 

The name of the tape drive to use 

The volume label of the tape 

The name that you want to assign to the save set 

The day of the week (if any) to be omitted in the incremental backup 


2. Be sure that an image backup of the system has been made, and also be sure that you 
continue to make regular image backups of the system. 


3. Submit the command procedure using the following command line: 


$ SUBMIT /AFTER=23 SYSSMANAGER: INCREMENTAL BACKUP 


4. Be sure that a tape is loaded on the device that you specified. When the incremental 
backup is complete, keep the tape in a safe place and do not use the tape again until you 
make another image backup of your system. 


a 

$! Resubmit this procedure -- 

S SUBMIT/AFTER="TOMORROW+23:0" SYSSMANAGER: INCREMENTAL BACKUP 
$! 

$ TODAY = f$cvtime ("today",,"weekday") 

$ IF TODAY .EQS. "Friday" THEN GOTO DONE 
5! 

SET NOON 

ON ERROR THEN GOTO DONE 

ON CONTROL Y THEN GOTO DONE 

SET PROC/PRIV= (OPER, BYPASS) 


—_ 


DNUMNNMNDN 


REPLY/ALL - 
"Incremental Backup About to Begin. Open Files Will Not Be Saved" 


$ BACKUP/RECORD/SINCE=BACKUP DRAO:,DRA1:,DRA2: - 
MTAO: INCREMENT.SAV /LABEL=INCREM 

$! 

S$ WRITE SYSSOUTPUT "---> Completed backup of save set" 

S$ WRITE SYSSOUTPUT "" 

$! 

SDONE: 

$ DISMOUNT MTAO: 

$ EXIT 
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RESTORING FILES FROM BACKUP COPIES 


You might need to restore files from your backup copies. To restore files, you use the BACKUP 
command to retrieve the files from a previously created save set. 


You can use the BACKUP command to restore the following: 
- All the files on a disk (or volume or volume set) 


¢ All the files in a specific directory tree (for example, all the files in a user's main directory 
and subdirectories) 


« One or more specific files 


¢ Files from an incremental backup 


The procedure for restoring files depends upon the type of restore operation and whether your 
most recent backup was an image or incremental backup. 


In general, the BACKUP command line that you use to restore files is as follows: 


BACKUP/qualifiers save_set_specification output_specifier 
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Restoring Files from an Image Backup 


To restore the entire contents of a disk when your most recent backup was an image backup, 
use the following procedure: 


1. 
2. 


Mount the disk, to which you will copy the files, using the MOUNT /FOREIGN command. 


Load the tape, disk, or diskette that contains the saved backup copy of your disk. 


Give the BACKUP command with the /IMAGE qualifier, using the following syntax: 


BACKUP /IMAGE device:save_set_specification output_specifier 


If you do not know the name of the save set, do one of the following: 


If the save set is on a disk, use the DIRECTORY command to determine the name of 
the save set, for example: 


$ DIRECTORY BACKUP DISK: [BACKUPS] 
Directory SYSSSYSDEVICE: [BACKUPS] 
19APRIL1991.SAV;1 

Total of 1 file. 


The save set is named 19APRIL1991.SAV. 


If the save set is on magnetic tape, load the tape and give the following command, 
substituting the name of the tape drive you use for MTAO: 


$ BACKUP/LIST/REWIND MTAO: 


Listing of save set(s) 


Save set: 19APRIL1991.SAV 
Written by: SYSTEM 
UIC: [000001, 000004] 


Date: 19-APR-1991 22:03:03.63 


The save set is named 19APRIL1991.SAV. 
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4. lf your backup copy is on more than one tape or diskette, repeat step 2 for each tape or 
diskette. | 


5. Dismount the disk onto which you just restored the files, using the /NOUNLOAD qualifier. 


The following example shows this process: 


$ MOUNT/FOREIGN DRA2: @ 
$ BACKUP/IMAGE MTA1:FULL_BACKUP.SAV/REWIND DRA2: @ 


$ DISMOUNT/NOUNLOAD DRA2: 3] 
In this sequence, the individual command lines do the following: 
@ Logically mount the disk DRA2. The files will be restored to this disk. 


@ Restore the directory structure and all the files from the save set FULL_BACKUP.SAV to 
the disk DRA2. 


The /IMAGE qualifier restores a logical duplicate of the original disk, so that the entire 
directory structure is restored and the files are placed in the proper directories. 


© Logically dismount the disk. 
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Restoring Files from an Incremental Backup 


Use the following procedure to restore files after one or more incremental backups: 


1. 


Mount the disk, using DCL MOUNT commands to which you will copy the files, using the 
/FOREIGN qualifier which prepares the file structure of the disk for restoring. 


Load the tape, disk, or diskette that contains the most recent image backup of the disk (or 
volume or volume set). 


Give the BACKUP command with the /IMAGE qualifier, using the following syntax: 
BACKUP/IMAGE device:save_set_specification output_specifier 


lf your backup copy is on more than one tape or diskette, repeat step 2 for each tape or 
diskette. 


Dismount the disk onto which you have just restored the files from the image backup, using 
the /NOUNLOAD qualifier. 


Mount the disk that you are restoring as a file-structured volume, using the following syntax: 
MOUNT device name: VOLUME LABEL 


Dismount the media that contained the image backup, and mount the tape, disk, or diskette 
that contains the most recent incremental backup of the disk (or volume or volume set). 


Restore your incremental save sets, beginning with the most recent backup. Use the 
following syntax to restore an incremental backup: 


BACKUP/INCREMENTAL save_set_specifier device specifier 


Continue restoring the incremental backups in reverse chronological order, (which allows 
you to have the most recent changes overwrite previous changes to files which have had 
activity) until you have processed al! of the incremental backups since the most recent 
image backup. If the incremental backups are on more than one tape or disk, then you 
must mount each of these successively. 


When you have processed the oldest incremental backup, the restore operation is complete. 
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The following example shows the process of restoring an entire disk after a series of incremental 


backups: 

$ MOUNT/FOREIGN DRA2: @ 

$ BACKUP/IMAGE/RECORD DBA3:WORK_DISK_BACKUP.SAV/SAVE_SET DRA2: 2] 

$ DISMOUNT/NOUNLOAD DRA2: @ 

$ MOUNT DRA2: USERI1 

$ BACKUP/INCREMENTAL DBA3:WORK_DISK_18 JAN.SAV/SAVE SET DRA2: 5 ] 

$ BACKUP/INCREMENTAL DBA3:WORK_DISK_17_JAN.SAV/SAVE_SET DRA2: 6 ] 

$ BACKUP/INCREMENTAL DBA3:WORK_DISK_16 JAN.SAV/SAVE_SET DRA2: @ 

In this sequence, the individual command lines do the following: 

@ Logically mount the disk DRA2. The files will be restored to this disk. 

@ Restore the directory structure and all the files from the save set WORK_DISK_ 
BACKUP.SAV to the disk DRA2. This was an image backup, which must be the first save 
set you restore when you want to restore incremental backup copies. 

© Logically dismount the disk DRA2. 

@ Remount the disk DRA2, this time as USER1, files-structured volume. 

@ Restore the most recent incremental backup. 

@ Restore the next incremental backup. 

@ Restore the last incremental backup. 


Restoring the incremental backups in reverse chronological order is the most efficient 
way to restore files. When you have restored the last incremental backup, the restoration 
process is complete. 
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LISTING THE CONTENTS OF A SAVE SET 


To list the contents of a save set, you must use the BACKUP command. There are two ways 
to list the contents of a save set: 


1. Use the /JOURNAL qualifier each time you back up your files. Then, use the BACKUP 
/JOURNAL/LIST command to list the contents of the save set. You use neither-an input 
specifier nor an output specifier with this command. 


2. Make available the save set containing your backup copies by ensuring that the backup 
media is mounted, and then use the BACKUP/LIST command. With this command, you 
use the backup media and the save set as your input specifier, and you do not use an 
output specifier. 


For example, suppose you had backed up a disk with this command: 


$ BACKUP /IMAGE /JOURNAL=SYSSMANAGER: FULL BACKUP.BJL - 
_§$ WORK _DISK: MTA1:FULL_ BACKUP. SAV 


You can list the contents of the save set on your terminal by using the following command: 
$ BACKUP /LIST /JOURNAL=SYSSMANAGER: FULL BACKUP.BJL 


You can also direct the contents of the save set to be listed in a file that you can read or edit 
with a text editor by supplying a file specification with the /LIST qualifier. 


For example, suppose that the save set containing your backup was on a tape that had been 
mounted on MTAO. To write the contents of the save set to a text file, enter the following — 
command: | 


S BACKUP /LIST=SYSSMANAGER:BACKUP FILES.DAT - 
_$ /JOURNAL=SYSSMANAGER: FULL BACKUP.BJL 


NOTE 


The system manager or operator must keep track of the names of the 
journal files. 
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SUMMARY 


The BACKUP utility allows you to save copies of all the files on your system. 


There are two types of backups: 

« Image (full) backups 

¢ — Incremental backups 

When you back up files in a save operation, the files are stored in units called save sets. 


The BACKUP command line has three key parts: 


BACKUP/qualifiers input_specifier/qualifiers output_specifier/qualifiers 


Command procedures can be used to ensure that system backups take place when you 
want them to. 


To restore files from your backup copies, use the BACKUP command to retrieve the files 
from previously created save sets. 


To list the contents of a save set, you must use the BACKUP command and the appropriate 
qualifiers. 
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APPENDIX - BACKUP QUICK REFERENCE TABLES 


The following tables serve as a quick reference to the various command actions and formats 
used in the BACKUP utility. 
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Table 4—1 shows BACKUP command formats for save operations and some of the qualifiers 
-you can use with a save operation. | 


Table 4-1 Save Operation Quick Reference Table 


Command Action 


Saves a file to a save set 
on magnetic tape 


Saves the most recent 
versions of files in a 
directory to magnetic tape 


Saves a disk volume to a 
save set on magnetic tape 


Saves a disk volume to a 
multivolume save set on 
more than one magnetic 
tape drive 


Saves a list of files toa 
save set on magnetic tape 


Saves a disk volume for 
incremental backups for the 
first time 


Saves a disk volume for 
incremental backups (not 
the first time) 


Saves an unstructured disk 
volume 


Command Format and Example 


BACKUP file-spec save-set-specifier/LABEL=label 
$ BACKUP STDAT1.DAT MTAO:STDAT1.BCK/LABEL=TAPEO1 


BACKUP [directory]*.*; save-set-specifier/LABEL=label 
$ BACKUP [LYON...]*.*; MTAO:MAR17.BCK/LABEL=W102 


BACKUP/IMAGE ddcu: save-set-specifier/LABEL=label 
$ BACKUP/IMAGE DBA1: MTAO: 9FEB4.BCK/LABEL=M101 


BACKUP/IMAGE ddcu: save-set-specifier,ddcu: . . . 
/LABEL=(label1, ... ) 
$ BACKUP/IMAGE DBA1: MTAO:17MAR.BCK,MTA1:/ - 


_S LABEL= (WKY101,WKY102) 


BACKUP file-spec,file-spec,... save-set-specifier/_LABEL=label 
$ BACKUP DBA1: [LYON...]*.PAS,DMAO: [DAKOTA...]*.PAS - 


_S MTAO:PAS17MAR.BCK/LABEL=TAPEO1 


BACKUP/RECORD/IMAGE/LOG ddcu: 
save-set-specifier/LABEL=label 
$ BACKUP/RECORD/IMAGE/LOG DBA1: MTA0: 9FEB4.BCK/ - 


_§$ LABEL=DLY101 


BACKUP/RECORD/FAST/LOG ddcu;[*...//SINCE=BACKUP 
save-set-specifier/LABEL=label 
$ BACKUP/RECORD/FAST/LOG DBA1: [*...]/SINCE=BACKUP - 


_§ MTAO:928FEB4.BCK/LABEL=DLY101 


BACKUP/PHYSICAL ddcu: save-set-specifier/LABEL=label 
$ BACKUP/PHYSICAL DMA1: MTAO: 935FEB4.BCK/LABEL=MTH101 
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Table 4-1 Save Operation Quick Reference Table (Cont) 


Command Action Command Format and Example 

Saves a directory to a save BACKUP [directory] save-set-specifier/SAVE_SET 

set on a Files—11 disk $ BACKUP [LYON] DBA2: [BACKUP] 9FEB3.BCK/SAVE_SET 

Saves a directory to a save BACKUP [directory] save-set-specifier/SAVE_SET 

set on a Files—11 disk on $ BACKUP [LYON] CHI10::DBA2: [BACKUP] 9FEB3.BCK/SAVE_SET 


another node in the network 


Saves a directory tree to a BACKUP [{direciory...] save-set-specifier/_LABEL=label 
save set on magnetic tape $ BACKUP [LYON...] MTAQ:1612FEB3.BCK/LABEL=TO1 


Saves a directory tree toa BACKUP/LIST=file-spec [directory...] save-set-specifier 
save set on magnetic tape /LABEL=label 


and creates a listing file $ BACKUP/LIST=8SEP.LOG [LYON...] MTAO:8SEP.BCK 
/LABEL=WKL101 

Saves a directory tree toa BACKUP {directory...] save-set-specifier 

save set on magnetic tape /MEDIA_FORMAT=COMPACTION 

using data compaction to $ BACKUP [TESTFILES...]*.*;* 


increase the amount of data MUAO:TEST.SAV/MEDIA_FORMAT=COMPACTION/REWIND 
stored on a tape cartridge 
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Table 4-2 shows BACKUP command formats for restore operations and some of the qualifiers 
you can use with restore operations. In the examples in this table, it is assumed that save sets 
already exist on the magnetic tape and disk. 


Table 4-2 Restore Operation Quick Reference Table 


Command Action 


Restores from save set on 
disk to Files—11 disk with 
original UICs 


Restores from a save set on 
magnetic tape to a Files—11 
disk with original UICs 


Restores from save set on 
disk on another node in the 
network to Files—11 disk 
with original UICs 


Restores a selected file in a 
save set on magnetic tape 
to a Files—11 disk 


Restores files with a specific 
UIC to a Files—11 disk 


Restores files to a Files—11 
disk with a new UIC 


Restores files to a Files—11 
disk; if file exists, creates 
new version 


Restores files to a Files—11 
disk; if file exists, replaces 
with new version 


Command Format and Example 


BACKUP save-set-specifier/SAVE_SET ddcu:[*...]/BY_ 
OWNER=ORIGINAL 
$ BACKUP DBA2: [BACKUP ]FEB2.BCK/SAVE_SET DBA1:[*...]- 


_$/BY_OWNER=ORIGINAL 


BACKUP save-set-specifier ddcu:[*...]//BY_OWNER=ORIGINAL 
$ BACKUP MTA0:1618FEB2.BCK DBA1: [*...] /BY_OWNER=ORIGINAL 


BACKUP save-set-specifier/SAVE_SET ddcu:[*...]/BY_ 
OWNER=ORIGINAL 
$ BACKUP CHI10: :DBA2: [BACKUP] 1622FEB2 .BCK/SAVE_SET - 


_$DBA1:[*...] /BY_OWNER=ORIGINAL 


BACKUP save-set-specifier/SELECT=file-spec file-spec 
$ BACKUP MTA0O:FEB2.BCK/SELECT=[POUDRE]UPLIFT.PAS - 


_$ DBA1: [GEO.PAS] UPLIFT.PAS 


BACKUP save-set-specifier/BY_OWNER=[uic] file-spec 
$ BACKUP MTAO:1641FEB2.BCK/BY OWNER=[360,052] - 


_$ DBA1: [LYON...] 
BACKUP save-set-specifier file-spec/BY_OWNER=[uic] 


$ BACKUP MTA0:1641FEB2.BCK - 


_S DBA1: [TESTS...]/BY_OWNER=[100, 150] 


BACKUP save-set-specifier file-spec/NEW_VERSION 
$ BACKUP MTAO:1641FEB2.BCK DBA1: [LYON...]/NEW_VERSION 


BACKUP save-set-specifier file-spec/REPLACE 
$ BACKUP MTA0:1641FEB2.BCK DBA1: [LYON...]/REPLACE 
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Table 4-2 Restore Operation Quick Reference Table (Cont) 


Command Action 


Restores files to a Files—11 
disk selecting certain files 


Restores a directory tree, 
placing files in a different 
subtree 


Restores a Files—11 volume 
from a physical save set 


Restores a Files—11 volume 
from an image save set 


Restores a Files—11 volume, 
maintaining the initialization 
parameters specified in the 
DCL command INITIALIZE 


Command Format and Example 


BACKUP save-set-specifier/SELECT=file-spec file-spec 
$ BACKUP MTA0:1641FEB2.BCK/SELECT=[LYON.PAS] - 


_$ DBA1:[LYON...] 


BACKUP save-set-specifier/SELECT=|directory...] 
[directory2...] 
$ BACKUP MTA0:1641FEB2.BCK/SELECT=[FIELD...] - 


_$ DBA1: [LYON.NEWDATA.. .] 


BACKUP/PHYSICAL save-set-specifier ddcu: 


$ BACKUP/PHYSICAL MTAO: 26MAR.BCK DMA3: 


BACKUP/IMAGE save-set-specifier ddcu: 
S$ BACKUP/IMAGE MTA0:17AUG.BCK DRA3: 


INITIALIZE ddcu: volume-name/new-parameters 
MOUNT/FOREIGN ddcu: 

BACKUP/IMAGE save-set-specifier ddcu:/NOINITIALIZE 
$ INITIALIZE DBA1: UTTLPACK/CLUSTER=5 

$ MOUNT/FOREIGN DBA1: 

$ BACKUP/IMAGE MTA0:17AUG.BCK DBA1:/NOINITIALIZE 
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Table 4-3 shows BACKUP command formats for copy operations, including some of the 
‘qualifiers you can use with a copy operation. 


Table 4-3 Copy Operation Quick Reference Table 


Command Action 


Copies a directory tree to 
another directory tree 


Copies a file to another file 


Copies a disk volume to 
another disk volume 


Copies a disk volume to 
another disk volume using 
the /PHYSICAL qualifier 


Copies two disk volume set 
using the /IMAGE qualifier 


Command Format and Example 


BACKUP [directory...] [directory...] 
$ BACKUP [DAKOTA...] [SUNDANCE...] 


BACKUP file-spec file-spec 
$ BACKUP LOGIN.COM [.SAVE] OLDLOGIN.COM 


BACKUP/IMAGE ddcu: ddcu: 
$ BACKUP/IMAGE DBA1: DBA2: 


BACKUP/PHYSICAL ddcu: ddcu: 
$ BACKUP/PHYSICAL DYA1: DYA2: 


BACKUP/IMAGE volume-set-name ddcu:,ddcu: 
S$ BACKUP/IMAGE USERS: DBA1:,DBA2: 


Table 4-4 shows BACKUP command formats for compare operations, including some of the 
qualifiers you can use with a compare operation. 


Table 4-4 Compare Operation Quick Reference Table 


Command Action 
Compares two Files—11 files 
Compares a selected file 


from a save set anda 
Files—11 file 


Compares an image save 
set and Files—11 files 


Command Format and Example 


BACKUP/COMPARE file-spec file-spec 
$ BACKUP/COMPARE UPLIFT.EXE;3 UPLIFT.EXE;2 


BACKUP/COMPARE save-set-specifier/select=file-spec file- 
spec 
$ BACKUP/COMPARE MTAO:FEB2.BCK/SELECT=[POUDRE]UPLIFT.PAS - 


_$ UPLIFT.PAS 


BACKUP/COMPARE/IMAGE save-set-specifier ddcu: 
$ BACKUP/COMPARE/ IMAGE MTA0O:120CT.BCK DRA3: 
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Table 4-5 shows BACKUP command formats for a list operation, including some of the qualifiers 
you can use with a list operation. 


Table 4-5 List Operation Quick Reference Table 


Command Action Command Format and Example 
Lists the files in a save set BACKUP/LIST save-set-specifier 
at the terminal $ BACKUP/LIST MTA0:1618FEB2.BCK 
Lists the files in a save set, BACKUP/LIST=file-spec save-set-specifier 
writes to a file $ BACKUP/LIST=NEWLIST.LIS MTAO:1618FEB2.BCK 
Lists the files in a save set BACKUP/LIST/FULL save-set-specifier 
in full format $ BACKUP/LIST/FULL MTA0:1618FEB2.BCK 
Lists selected files ina BACKUP/LIST/JOURNAL=journal-name/selection-qualifiers 
journal file $ BACKUP/LIST/JOURNAL=SYSSMANAGER: INCBACKUP - 
_$ /SELECT=[LYON.WORK...] /SINCE=1-JAN-1991 
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Introduction to System Customization 


INTRODUCTION 


This chapter presents the basic concepts of system customization. Among the topics covered 
are: 


¢- The definition and identification of the different system startup and login command 
procedures 


+ The AUTOGEN and SYSMAN commands used to set system parameters 
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OBJECTIVES 


To describe the task and responsibilities involved with installing and updating system software, 
a system and network manager should be able to: 


- — Identify the functions of the different system startup and login command procedures 
* Set up a captive account 


- Use AUTOGEN and SYSMAN to set system parameters 


RESOURCES 


« VMS System Generation Utility Manual 

¢ VMS Install Utility Manual 

¢« VMS System Manager's Manual 

* Guide to Setting Up a VMS System 

° VAX Systems/DECsystems Systems and Options Catalog 
¢« VMS V/O User's Reference Manual: Part ! 


¢ VMS Installation and Operation Guide for your particular VAX system 
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TOPICS 


* System startup files 


Site-independent startup file 

Configuring devices 

Defining system-wide logical names 
Executive-mode logical name requirements 
Installing paging and swapping files 
General site-specific startup functions 


Login command procedures 


« Maintaining system parameters 


Utilities for maintaining system parameters 
Changing physical resources 
Reconfiguring the system with AUTOGEN 
Running AUTOGEN 

SYSMAN parameters 


Switching window systems 


Introduction to System Customization 5-5 


SYSTEM STARTUP FILES 


The sequence of operations for STARTUP.COM is as follows: 
1. SYSSMANAGER:SYCONFIG.COM 


Connects various devices to system and loads their |/O drivers 
Initially empty. If left empty, system automatically configures all devices 


2. To add new drivers to the system configuration, the SYSGEN command AUTOCONFIGURE 
ALL executes unless canceled by the user. 


lf the symbol STARTUP$AUTOCONFIGURE_ALL is set to ("0") or "FALSE", this step is not 
performed. 


3. SWAPFILE1.SYS, if present, is installed. 


4. The CONFIGURE process (swappable) starts. If the SYSGEN parameter NOAUTOCONFIG 
is set to 1, the CONFIGURE process is not started. 


If the symbol STARTUP$AUTOCONFIGURE_ALL is defined as ("0") or "FALSE" , the step 
is not performed. 


5. SYSS$MANAGER:SYLOGICALS.COM 
Used to define system-wide logical names 
6. SYS$MANAGER:SATELLITE_PAGE.COM executes 


Mounts the satellite’s local disk 
Installs the paging and swapping files on the satellite’s local disk 


7. SYS$MANAGER:SYPAGSWPFILES.COM 
Used to install paging and swapping files on any disk 
8. SYSS$MANAGER:SYSECURITY.COM executes 


Runs prior to starting the audit server process 
Used to mount or define any disks that hold security auditing log files or local security 
archive files 


9. SYS$MANAGER:SYSTARTUP_V5.COM 
General location for site-specific customization commands not addressed by other 


site-specific startup files 
Overrides commands in STARTUP.COM file 
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Site-Independent Startup File 


SYSS$SYSTEM:STARTUP.COM 


STARTUP.COM uses a series of component files that accomplish many functions, such as: 


Assigning logical names required by certain VMS system software 
Assigning logical names to the VMS system directories 

Starting up system processes such as 

— JOB_CONTROL 

— QUEUE MANAGER 

— OPCOM 

— ERRFMT 

Installing Known images 

Connecting all standard devices 


Calling the site-specific startup command procedures 


These component files are located in a set of directories associated with the system-wide 
logical name SYS$STARTUP. 


STARTUP.COM starts up the system: 


Four basic phases (INITIAL, CONFIGURE, DEVICE, BASEENVIRON) 

Three data files (located in SYS$STARTUP) 

—  VMS$PHASES.DAT - determines the order of the phases during the startup procedure 
— VMS$VMS.DAT - data file for starting the base VMS operating system environment 
— VMS$LAYERED.DAT - data file for layered products that are installed at system startup 


NOTE 


Never modify VMS$PHASES.DAT or VMS$VMS.DAT. These files contain 
important site-independent information that can change from one VMS 
system release to the next. 
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Configuring Devices | 
SYCONFIG.COM 


SYS$MANAGER:SYCONFIG.COM is the second site-specific startup file invoked by 
STARTUP.COM. SYCONFIG.COM is used to connect special devices to the system and 
load their I/O drivers. 


* Only necessary for nonstandard devices or unusual device settings. 

* SYSGEN commands are typically placed in this file. 

*« You can optionally place MOUNT commands in this file. 

¢ Most sites mount remaining disks in SYSTARTUP_V5.COM file. 

e When SYCONFIG.COM completes, control is returned to STARTUP.COM. 


— STARTUP.COM automatically connects all remaining devices and loads their I/O 
drivers. 


— Connecting and loading is accomplished by the SYSGEN AUTOCONFIGURE ALL 
command. 


Example 5-1 Sample SYCONFIG.COM 


$! 
$! SYSSSTARTUP :SYCONFIG.COM 

$! 

$! Set virtual terminals.... 

$! 

$ RUN SYSSSYSTEM:SYSGEN 

CONNECT VTAO/NOADAPTER/DRIVER=TTDRIVER 
CONNECT TDAO/NOADAPTER/DRIVER=TDDRIVER 
EXIT 

SEXIT 
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Defining System-Wide Logical Names 
SYLOGICALS.COM 


SYS$MANAGER:SYLOGICALS.COM, a site-specific command procedure invoked by 
STARTUP.COM, is used to define system-wide logical names. A template file is supplied 
by Digital. 


* Define system components as executive-mode logical names. 


¢ To create system logical names: 


$ ASSIGN/SYSTEM 
$ DEFINE/SYSTEM 


* To delete system logical names: 


$ DEASSIGN/SYSTEM 


Typically you would use the /NOLOG qualifier with either DEFINE or ASSIGN to reduce the 
amount of printout on the console terminal during system startup. 


Table 5—1 lists logical name assignments. 


Table 5—2 lists some of the logical names commonly defined in SYLOGICALS.COM for any 
given VMS operating system site. 


Refer to Example 5-3 for a sample SYLOGICALS.COM. 
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Table 5~1 shows how to assign system logical names. 


Table 5-1 Assigning System Logical Names 
Command Format/Example 


Operation (Requires SYSNAM privilege) 
Create or replace a system $ ASSIGN/SYSTEM eqv-name log-name 
logical name . $ DEFINE/SYSTEM log-name eqv-name 


$ ASSIGN/SYSTEM SYSSSYSTEM: NOTICE.TXT NOTICE 


Delete a system logical name $ DEASSIGN/SYSTEM log-name 
$ DEASSIGN NOTICE 


Table 5-2 lists some standard logical names to define. 


Table 5-2 Some Standard Logical Names to Define in SYLOGICALS.COM 


Name Definition Function 

SYS$SYLOGIN Name of system-wide login The system executes this procedure 
command procedure when it creates a process. 

SYS$ANNOUNCE Line of text or name of file The system displays this line or the 
containing text contents of the file when the user 


presses the RETURN key to log in. 


SYS$WELCOME Line of text or name of file The system displays this line or 
containing text the contents of the file after a user 
successfully logs in (by default, 
“Welcome to VMS V5.5") 
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Executive-Mode Logical Name Requirements 

Logical names for some system components and files must be defined in executive-mode. 
Examples of components and files you would set up executive-mode logical names for: 

* Public disks and directories 

* SYSUAF.DAT 

¢ RIGHTSLIST.DAT 

¢ VMSMAIL_PROFILE.DATA 

« NETPROXY.DAT 


To define an executive-mode logical name: 


$ DEFINE/SYSTEM/EXECUTIVE/NOLOG logical-name equivalence-name 


Examples of defining logical names in executive mode are shown in Example 5-2. 


Example 5-2 Assigning Site-Specific System Logical Names (SYLOGICALS.COM) 


$! 

$! Assign site-specific logical names 

$! 

$ ASSIGN /SYSTEM /EXEC /NOLOG DISKSUSER: [PUBLIC] SYSSPUBLIC 
$ ASSIGN /SYSTEM /EXEC /NOLOG DISKSUSER: [TOOLS] SYSSTOOLS 


$ ASSIGN /SYSTEM /EXEC /NOLOG "This is the MENTOR system" SYSSANNOUNCE 
$ ASSIGN /SYSTEM /EXEC /NOLOG "@SYSSMANAGER:WELCOME.TXT" SYSSWELCOME 
$! 
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Example 5-3 Sample SYLOGICALS.COM 


SYSSSTARTUP: SYLOGICALS.COM 
ET NOON 
Define any site-specific logical names below: 


This includes site-specific cluster common file definitions (previously 
defined in the site-specific file SYENVIRON.COM). 

The user should include definitions that define the location of 

SYSUAF, NETUAF, VMSMAIL, RIGHTSLIST, NETNODE REMOTE, and LMFSLICENSE. 

Include a MOUNT/SYSTEM command for the disk that these files reside on. 

See SYSSEXAMPLES:CLU_MOUNT DISK.COM for the recommended method of doing this. 


: 
, 
S 
: 
‘ 
: 
: 
: 
: 
, 
! 
! 
: 


node = fS$getsyi ("nodename") 
t 


ASSIGN/SYSTEM/EXEC 
' 


ASSIGN/SYSTEM/EXEC 


WORK4 : [COMMON _SYSEXE] SYSSCOM_FILES 


SYSSCOM_FILES:SYSUAF.DAT SYSUAF 


ASSIGN/SYSTEM/EXEC 
ASSIGN/SYSTEM/EXEC 
ASSIGN/SYSTEM/EXEC 
ASSIGN/SYSTEM/EXEC 
' 
ASSIGN/SYSTEM/EXEC 
ASSIGN/SYSTEM/EXEC 


SYSSCOM_FILES:NETPROXY.DAT NETPROXY 
SYSSCOM_FILES:RIGHTSLIST.DAT RIGHTSLIST 
SYSSCOM_FILES:VMSMAIL PROFILE.DATA VMSMAIL PROFILE 
SYSSCOMMON: [SYSEXE] NETNODE REMOTE.DAT NETNODE REMOTE 


7 MAILSSYSTEM FLAGS 


SYSSCOMMON: [SYSMGR]SYLOGIN SYSSSYLOGIN !'remove .com for MCR CLI 


ASSIGN/SYSTEM/EXEC "Software Course Development" PSMSANNOUNCE 
ASSIGN/SYSTEM/EXEC - 


! Header to printouts 


MMW MNAUNNNMNANNUNANMNUYN UNUM NUN HNN YNYHMWUNYNYNYNMYHUMNUNYN 
| 
I 
! 
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{ 
t 
! 
{ 
! 
! 
! 
l 
I 
! 
! 
I 
! 
l 
| 
! 
I 
i 
j 
i 
j 
t 
§ 
+ 


Node: ’’node’ 


UNAUTHORIZED ACCESS IS PROHIBITED 


" 


SYSSANNOUNCE 

$ ASSIGN/SYSTEM/EXEC "@SYSSCOMMON: [SYSMGR] WELCOME.TXT" 
$ ASSIGN/SYSTEM 0 SHUTDOWNSMINIMUM MINUTES 
$! Location of COMMON system reports 

$ ASSIGN/SYSTEM/EXEC/TRANS= (TERM, CONCEAL) 
$! 


SYSSWELCOME 


S1SDUA4: [SYSSINFO.] SYSSINFO 
Define the location of the WORK4: [TEMPLATE] directory 

$! 

DEFINE/EXEC/SYSTEM TEMPLATES 


DEFINE/EXEC/SYSTEM TEMPLATE 
! 


WORK4: [TEMPLATES] 
WORK4: [TEMPLATES] 


! Define logical name for DECgraph 
! 


ASSIGN/SYSTEM SYSSCOMMON: [DECGRAPH] GRAPHSLIBRARY 
Define logical names specific to Satellite nodes 


if ("’'node’" .EQS. "MOPPET") .OR. ("’'node’" .EQS. "BONKRS") THEN $GOTO CI_NODE 


a a ee ee 


{DEFINE /SYSTEM /EXEC DOCSBATCH "’ ‘node’ DOCSBATCH" 
' 


$CI_NODE: 
SEXIT 


GDA NMNDNUNMUNNAUNNMNM 
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Installing Paging and Swapping Files 
SYPAGSWPFILES.COM 


SYS$MANAGER:SYPAGSWPFILES.COM is the third site-specific startup file invoked by 
STARTUP.COM. It is used to install paging and swapping files on disks other than the system 
disk. 


Before invoking SYPAGSWPFILES.COM, the system activates the following files if they exist in 
SYS$SYSTEM: 


« PAGEFILE.SYS 
¢ SWAPFILE.SYS 
* SYSDUMP.DMP 


STARTUP.COM then invokes SYPAGSWPFILES.COM. 


To activate additional paging and swapping files, insert whatever commands are needed for the 
installation, including: 


¢ MOUNT 
— Mount disks containing additional swapping and paging files 
¢ SYSGEN 


— Create and/or install additional paging and swapping files — 


Example 5-4 Sample SYPAGSWPFILES.COM 


S SET NOON 

S SET NOCONTROL Y 

Bt 

$ ! SYSSMANAGER: SYPAGSWPFILES.COM 

$ ! 

$ ! This is a sample system paging and swapping file command procedure 
$ t-- 

$ MOUNT/SYSTEM $1S5DUA4: PGSWP 

RUN SYSSSYSTEM: SYSGEN 

INSTALL $1S$DUA4: [SYSEXE] PAGEFILE.SYS/PAGEFILE 
INSTALL $1$DUA4: [SYSEXE] SWAPFILE.SYS/SWAPFILE 
EXIT 

$ EXIT 


Beea 
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General Site-Specific Startup Functions 
SYSTARTUP_V5.COM | 


SYS$MANAGER:SYSTARTUP_V5.COM is the final site-specific command procedure invoked 
by STARTUP.COM. A template file is supplied by Digital. 


SYSTARTUP_V5.COM is used to accomplish functions not covered by the other site-specific 
command procedures, such as: 


¢ Mounting public disks 

¢ Setting device characteristics 

¢ Initializing and starting batch and print queues 

¢ — Installing known images 

¢ Starting up DECnet software (if it exists) 

¢ Analyzing most recent system failure 

¢ Purging unwanted operator log files 

« Starting up the LAT network (if it exists) 

¢ Defining the maximum number of interactive users 

« Announcing the VMS system is up 

¢ Starting layered products 

¢ Allowing users to log in 

Use separate command procedures for major functions to: 
— Keep SYSTARTUP_V5.COM small and manageable 
— Allow clean, separate execution of functions after system has been started 


Sometimes needed when certain failures occur and the function needs to be reactivated 
(For example: print and batch queues) 
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Example 5-5 illustrates the SYSTARTUP_V5.COM command procedure. 
Example 5-5 SYSTARTUP_V5.COM Command Procedure 


SET NOON 

SET NOCONTROL_Y 

44 

! SYSSMANAGER: SYSTARTUP_V5.COM 
1 


! This is a sample site-specific system startup command procedure 


!—— 

: 

! Create logical name for supporting command procedures 
DEFINE/NOLOG STARTUP_PROCS SYSSSYSROOT: [SYSMGR.STARTUP] 
! 

! Mount site-specific volumes 

@STARTUP_PROCS :MOUNTDSK.COM 

! 

! Set device characteristics 

@STARTUP_PROCS: DEVICES .COM 

f 

! Define and start print queues 
@STARTUP_PROCS:START_PRNT_QUEUE.COM 

t 

! Define and start batch queues 
@STARTUP_PROCS:START_BATCH_ QUEUE .COM 

! 

! Install known images 
@STARTUP PROCS: INSTALL.COM 

U 

! Start DECnet software 
@SYSSMANAGER : STARTNET. COM 

{ 

! Start LAT network 

@SYSSMANAGER: LTLOAD.COM 

! 

! Create reports about the last system failure 
@STARTUP_PROCS:REPORT_FAILURE.COM 

t 

! Purge old versions of system log files 
PURGE/KEEP=3 SYSSMANAGER: * . LOG 

! Set the maximum number of interactive users 
STARTUPSINTERACTIVE LOGINS == 40 

! 

! Announce availability of the system to all terminals 
SUBMIT STARTUP_PROCS:START_ ANNOUNCE.COM 

J 

! End of SYSSMANAGER:SYSTARTUP_V5.COM 

! 


EXIT 


PUN UMNNH UMM MNNUVUNNUNYNUNUNHNNUNAUNANNUNUNUNNOUNUNYHYNYNMNUNYHUNYNUNUNUNNUNYN 
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Login Command Procedures 


The VMS operating system provides further capability to specify the user’s environment in the 
form of login command procedures. 


Login command procedures can be: 
« System-wide login command procedures 
¢ Other login command procedures (created by system manager or user) 


« Executed each time an interactive process or batch job is created 


The VMS system expects to find these command procedures in: 

« System logical name SYS$SYLOGIN (system-wide procedure) 
* LGICMD field in each user’s UAF record 

¢ Default user login file LOGIN.COM 


The VMS login command procedure execution sequence: 
- If SYS$SYLOGIN is defined, execute the procedure it designates 
¢ If LGICMD contains the name of a command procedure, execute it 


¢ If LGICMD is blank, execute SYS$LOGIN:LOGIN.COM 


Common uses of login command procedures include: 

¢ Personal login only 

« System and personal login 

* System and group login 

¢ Captive login 

These command procedures are discussed in Table 5-3. 


Example 5-6 shows a sample login to a captive account. 
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Table 5-3 Typical Login Command Procedures (DCL) 


Function of Login Command Procedures 


Personal login only: 
DCL users create the file LOGIN.COM in their own login 
default directories to customize their own environments. 


System and personal login: 

The system manager creates the command procedure 
SYS$MANAGER:SYLOGIN.COM to customize a 
common user environment for all users on the system. 
Users each create a file, LOGIN.COM, in their own login 
default directories to customize their own environments. 


System and group login: 

The system manager creates the command procedure 
SYS$MANAGER:SYLOGIN.COM to customize a 
common user environment for all system users. Group 
managers create a command procedure to customize a 
common user environment for all users in their group. 


Captive login: 

The system manager creates a file in 

the SYS$MANAGER directory, such as 
SYS$MANAGER:CAPTIVE.COM, to customize the 

user environment and prevent a user from changing it. 
Typically, the command procedure examines each DCL 
command the user enters, to decide whether or not to 
allow it to be executed. It may even implement a private 
command language for the user. Captive accounts may 
also use the captive login method. Typically, more than 
one person uses a captive account. When users log in 
to a captive account, the login procedure runs a program 
for them, and they communicate with that program. 
Normally, a user of a captive account never sees the 
DCL prompt (see Example 5-6). 


Definition of System 
Logical Name SYS$SYLOGIN and 
UAF Record Field LGICMD 


SYS$SYLOGIN undefined 
LGICMD undefined 


SYS$SYLOGIN defined as 
SYS$MANAGER:SYLOGIN 


LGICMD undefined 


SYS$SYLOGIN defined as 
SYS$MANAGER:SYLOGIN 


LGICMD defined as the file 
created for the group that the user 
belongs to (see Example 8-3). 


SYS$SYLOGIN definition optional; 
affects captive and non-captive 
users. 


LGICMD contains the name of 

a captive command procedure, 
such as 
SYS$MANAGER:CAPTIVE, or | 
a logical name translating to the 
captive command procedure 
name. A captive command 
procedure must contain a loop 
to prevent it from exiting, and the 
FLAGS field of the UAF record 
must specify the CAPTIVE flag. 
Table 8-12 discusses the FLAGS 
field of the UAF record further. 
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Setting Up a Captive Account 


Modify the user account to include the CAPTIVE flag and the command procedure name in the 
LGICMD field. For example: 


$ RUN AUTHORIZE 
UAF> MODIFY SPECULATE /FLAG=CAPTIVE /LGICMD=SYS$MANAGER: CAPTIVE .COM 
UAF> EXIT 


In the above example, SYSSMANAGER:CAPTIVE.COM would call the program for the user. 
Example 5-7 provides a sample CAPTIVE.COM. 


Example 5-6 Using a Captive Account 


Username: SPECULATE 
Password: 


Welcome to SPECULATE 


Speculate> USE INVESTMENT DATA 

Spec: Consider it done. 

Speculate> COMPUTE FOR NEXT 10 YEARS 
SPEC: Please specify commodity. 
Speculate> GOLD 

Spec: $933,999,456,657.32 

Speculate> 


(User continues to interact with the SPECULATE program) 


Speculate> BYE 
SPECULATE logged out at 04-NOV-1991 16:00:15.16 


Example 5-7 Captive Command Procedure (CAPTIVE.COM) 


$! CAPTIVE.COM 

S! 

ON ERROR THEN LOGOUT 

SET NOCONTROL=Y 

ON CONTROL-Y THEN LOGOUT 

WRITE SYSSOUTPUT "Welcome to Speculate" 
DEFINE/USER SYSSINPUT SYSSCOMMAND 

RUN SYSSSYSTEM: SPECULATE 

LOGOUT 


MMmNADNMMDM 
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MAINTAINING SYSTEM PARAMETERS 


VMS operating system parameters control such things as: 


- Sizes of VMS data structures in memory 


¢ Number of installed image files 


¢ Sizes of system files 


Automatically customized at system installation: 


- SYS$SYSTEM:VAXVMSSYS.PAR (system parameters) 


¢ SYS$MANAGER:VMSIMAGES.DAT (list of images to install) 


* Paging file (size) 
¢ Swapping file (size) 


¢« Dump file (size) 


Table 5—4 lists these files and their functions. 


Table 5-4 System Files 


File 
Paging file 
Swapping file 


Dump file 


Default File Specification 


SYS$SYSTEM:PAGEFILE.SYS 
SYS$SYSTEM:SWAPFILE.SYS 


SYS$SYSTEM:SYSDUMP.DMP 


Function 


Manages virtual memory 


Manages physical memory 
use 


Saves a partial copy of 
physical memory when the 
system fails 
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Utilities for Maintaining System Parameters 
To change current parameter values you need CMKRNL privilege. To make 


changes to the default parameter values you need write access to the parameter file 
SYS$SYSTEM:VAXVMSSYS.PAR. 


System Generation Utility (SYSGEN) 


The system generation utility (SYSGEN) is a system management tool that performs certain 
privileged system configuration functions: 


¢ Creates and modifies system parameters (not recommended) 
¢ Loads device drivers 


¢ Creates additional paging and swapping files 


AUTOGEN Command Procedure 


When you boot your system during installation, the AUTOGEN command procedure generates 
system parameters that are suitable for your hardware configuration. However, if you have 
an unusual hardware configuration or special workload requirements, you may want to modify 
some system parameters and rerun AUTOGEN. 


NOTE 


Digital reeommends the use of the AUTOGEN command procedure when 
modifying system parameters and creating/adding paging and swapping 
files. For this reason, SYSGEN is not specifically taught in this course. 


System Management Utility (SYSMAN) 


The system management utility (SYSMAN) centralizes the management of nodes and 
VAXcluster environments. Rather than logging in to individual nodes and repeating a set of 
management tasks, SYSMAN allows you to define your management environment to be a: 


¢ Particular node 
¢ Group of nodes 


* VAXcluster environment 


With a management environment defined, you can perform system management tasks from 
your local node. SYSMAN executes these tasks on all nodes in the target environment. 
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Changing Physical Resources 
A change in physical resources should be accompanied by a change in: 
¢ System parameter values 


« System file sizes 


An example of a change in physical resources is when you have: 
¢ Added new hardware 


« Added more memory 


Tools to use: 
* SYS$UPDATE:AUTOGEN.COM - command procedure (recommended method) 
— Determines hardware resources 
— Computes system parameters 
— Creates list of image files to install 
— Calculates size of paging, swapping, and dump files 
- SYS$SYSTEM:SYSMAN - utility 
— Changes system parameters - 
¢ SYSBOOT - conversational startup utility 


— Changes system parameters 
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Reconfiguring the System with AUTOGEN 


AUTOGEN runs automatically at system installation. 


Determines system hardware resources 

Records appropriate system configuration (to be established at startup) 
Sets system parameter values using SYSGEN utility 

Creates list of images to install 

Creates system files using SYSGEN utility 


Optionally reboots the system to allow new parameters to take effect 


You should run AUTOGEN: 


During a new installation or upgrade 
When system physical resources change 
When system workload changes significantly 


When you add a layered (optional) software product. The product installation guide tells 
you what parameters you need to adjust. 


When you install a shared image 


To specify a system parameter value or file size manually 


To run AUTOGEN: 


$ @SYSSUPDATE:AUTOGEN [start-phase] [end-phase] [execution-mode] 


Table 5—5 lists AUTOGEN phases. See the Guide to VMS Performance Management tor more 
information about AUTOGEN. 
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Table 5—~5 AUTOGEN Phases 


Phase 
SAVPARAMS 


GETDATA 


GENPARAMS 


TESTFILES 


GENFILES 


SETPARAMS 


SHUTDOWN 


REBOOT 


HELP 


All data files are in the directory SYS$SYSTEM:. 


Function 


Records feedback 
data 


Collects data 
required for 
calculations 


Calculates 
parameter values 
and file sizes, and 
generates list of 
images to install 


Displays 
calculated file 
sizes 


Generates new 
files 


Saves calculated 
parameters 


Shuts down the 
system 


Reboots to allow 
new files and 
parameters to 
take effect . 


Provides 
information about 
AUTOGEN and its 
phases 


Input Files 


None 


MODPARAMS.DAT 
VMSPARAMS.DAT 


AGEN$FEEDBACK.DAT 


PARAMS.DAT 


PARAMS.DAT 


PARAMS.DAT 


SETPARAMS.DAT 


None 


None 


None 


NOTE 


Output Files 
AGEN$FEEDBACK.DAT 


PARAMS.DAT 


SETPARAMS.DAT 
VMSIMAGES.DAT 
AGEN$PARAMS.REPORT 


SYSS$OUTPUT 


PAGEFILE.SYS 
SWAPFILE.SYS 

(and secondary paging 
and swapping files) 
SYSDUMP.DMP 
AGEN$PARAMS.REPORT 


VAXVMSSYS.PAR 
AUTOGEN.PAR 
VAXVMSSYS.OLD 


None 


None 


None 
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Running AUTOGEN | 
Modifying System Parameters Without Changing File Sizes 


1. $ Q@SYSSUPDATE:AUTOGEN SAVPARAMS GENPARAMS 

2. Review these files: 
— PARAMS.DAT (information required for AUTOGEN calculations) 
— SETPARAMS.DAT (calculated parameters) 
— AGEN$PARAMS.REPORT (report on feedback data) 


3. If you want to change any parameters, edit MODPARAMS.DAT and rerun AUTOGEN as in 
step 1. 


4. $ @SYSSUPDATE : AUTOGEN SETPARAMS REBOOT 


Changing System Parameters and File Sizes 


1. S$ @SYSSUPDATE :AUTOGEN SAVPARAMS TESTFILES 
2. Examine file sizes. 
3. If you want to change file sizes, edit MODPARAMS.DAT and rerun AUTOGEN as in step 1. 


4. $ @SYSSUPDATE :AUTOGEN GENPARAMS REBOOT 


Example 5-8 shows a MODPARAMS.DAT file. 
Example 5-8 MODPARAMS.DAT File 


! MODPARAMS.DAT for node DITTO 

1 

SCSSYSTEMID = 2197 

SCSNODE = "DITTO " 

PAGEFILE = 60000 

‘ADD GBLPAGES = 425+507+157 ! CMS, BLISS32 and ADA (FJM 9/13/90) 


ADD_GBLSECTIONS = 4+5+2 ! CMS, BLISS32 and ADA (FJM 9/13/90) 
LOCKIDTBL = 2048 ! FOR RDB (A. B. 9/25/90) 

SHASHTBL = 16384 ! raised for CDD 40+ (D. E. 2/22/91) 
kity_viRTUALeAGECND = 136100! for VTX (vhm 5/25/91) 


00-7 Ne 
aie 


Y wo 
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SYSMAN PARAMETERS 


The SYSMAN PARAMETERS command lets you perform the following actions on system 
parameters and parameter files: 


* Inspect 
> Set 
* Modify 


The format for the SYSMAN PARAMETERS command is: 


SYSMAN> PARAMETERS subcommand 


Table 5-6 SYSMAN PARAMETERS Subcommands 


Subcommand Function 
SET Modifies the value of a system parameter in the work area. 
SHOW Displays the values of system parameters in the work area, 


pilus the default, minimum, and maximum values of the 
parameters and their units of measure. 


USE Initializes the current work area with system parameter values. 

WRITE Writes the system parameter values to a parameter file, to 
the current system parameter file, or to the active system in 
memory. 
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Example 5-9 SYSMAN PARAMETERS Command 


@ sysman> SET ENVIRONMENT /NODE=BARNUM 
SSYSMAN-I-ENV, current command environment: 
Individual nodes: BARNUM 
Username PRIDE will be used on nonlocal nodes 


@ sYSMAN> SET PROFILE/PRIVILEGE=CMEXEC 


© sysman> PARAMETERS SHOW /ACP 
@ sSYSMAN-I-USEACTNOD, a USE ACTIVE has been defaulted on node BARNU 
Node BARNUM: Parameters in use: ACTIVE 


Parameter Name Current Default Minimum Maximum Unit Dynamic 
ACP_MULTIPLE 0 0 0 1 Boolean D 
ACP_ SHARE 1 1 0 1 Boolean 

ACP_MAPCACHE 8 8 1 -l1 Pages D 
ACP_HDRCACHE 36 128 3 -1 Pages D 
ACP_DIRCACHE 36 80 2 -1 Pages D 
ACP_DINDXCACHE 9 25 2 -1 Pages D 
ACP _WORKSET 0 0 0 -1 Pages D 
ACP_FIDCACHE 64 64 0 ~l1 File-Ids D 
ACP_EXTCACHE 64 64 0 -~l1 Extents D 
ACP_EXTLIMIT 100 100 0 1000 Percent/10 D 
ACP_QUOCACHE 21 64 0 ~1 Users D 
ACP_SYSACC 4 8 0 -1 Directories D 
ACP_MAXREAD 32 32 1 64 Blocks D 
ACP_ WINDOW 7 7 1 -l1 Pointers D 
ACP_WRITEBACK 1 a 0 1 Boolean D 
ACP_DATACHECK 2 2 0 3 Bit-mask D 
ACP _BASEPRIO 8 8 4 31 Priority D 
ACP _SWAPFLGS 14 15 0 15 Bit-mask D 
ACP_XQP_RES a BY 0 1 Boolean 

ACP_REBLDSYSD 1 iL 0 1 Boolean 


Notes on Example 5-9: 

@ Establish the target node. 

@ Set the privilege of the profile to enable the next command. 

© Display the value of a group of parameters. You may display a specific parameter. 
4) 


Note that USE ACTIVE is assumed. 
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Switching Window Systems 


There may be times that you want to switch windowing systems from VWS to DECwindows or 
vice versa. To do this: 


1: 


Delete all AUTOGEN FEEDBACK files 


$ DELETE SYSSSYSTEM: AGENS* .DAT;* 


Change the the WINDOW_SYSTEM SYSGEN parameter 
$ RUN SYSSSYSTEM: SYSMAN 
SYSMAN> PARAMETERS SET WINDOW SYSTEM 1 ! or 2 for VWS 


SYSMAN> PARAMETERS WRITE CURRENT 
SYSMAN> EXIT 


Reboot the system using the following command: | 


S$ @SYSSSYSTEM: SHUTDOWN 


After the reboot, execute AUTOGEN using the following command: 


$ @SYSSUPDATE:AUTOGEN GETDATA REBOOT NOFEEDBACK 


The system will automatically reboot again using the newly generated DECwindows or 
VWS parameters 
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* There is a sequence of operations that STARTUP.COM goes through when starting up the 
system. STARTUP.COM is also responsible for: 
— Starting up other system startup files that need to be run 
— Executing the AUTOCONFIGURE ALL command unless canceled by the user 
— _ Installing optional swapping files if they are present 
— Starting the configuration process if the parameter is set accordingly 

¢ After starting up the system, the VMS operating system provides further capability to specify 
the user’s environment using login command procedures. There are two types of login 
command procedures: 
— System-wide login command procedures 
—— Other login command procedures that are created by the system manager or the user 


¢ Using login command procedures you can create a restricted environment for a user to 
work in. 


¢« Once a system is in operation you can modify system parameters to control such things 
as: 


— Sizes of VMS data structures in memory 
— Number of installed image files 
— Sizes of system files 
¢« VMS provides three. tools to modify these system parameters 
— The SYSGEN utility 
— The AUTOGEN command procedure 
— The SYSMAN utility 
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Layered Product Installation 


INTRODUCTION 


This chapter presents the basic concepts used in installing optional (layered) software products. 
Among the topics covered are: 


« The responsibilities of managing product licenses 


« The steps used in installing optional (layered) software products 
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OBJECTIVES 


To install optional (layered) software products, a system and network manager should be able 
to: 


¢ Describe the license management facility (LMF) 
¢ Use the license management facility (LMF) to manage the software license database 


* — Install optional (layered) software products on a single VMS system or in a VAXcluster 
environment 


RESOURCES 


¢ Installation guide for each product you are installing 


« VMS License Management Utility Manual 
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TOPICS 


* Overview of optional (layered) software products installation 
- The license management facility (LMF) 
« Managing product licenses 
— Overview of the license management facility (LMF) 
— Components of the LMF 
— The license management utility (LICENSE) 
¢ Installing layered products 
— Adjusting user privileges and quotas 
— Adjusting SYSGEN parameters 
« — Installing layered products on a common system disk 


« Appendix - License utility subcommands 
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OVERVIEW OF OPTIONAL (LAYERED) SOFTWARE 
PRODUCTS INSTALLATION 


« Use SYS$UPDATE:VMSLICENSE.COM to register the product authorization key (PAK) for 
the product. 


¢« Consult optional product’s software installation guide for additional steps and further 
instructions. 


— Some optional software is part of the VMS kit and requires no further installation. 
These system integrated products include: 


DECnet VAX 
VAxXcluster software 
VMS Volume Shadowing 
VAX RMS Journaling 


— For most products, you use SYS$UPDATE:VMSINSTAL.COM to copy the product 
software to the system disk. 


« For some products, you must adjust user quotas or system parameters. 


¢« Some products must be installed in a certain order and the product's installation guide 
should be read carefully to find out what the order is. 
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THE LICENSE MANAGEMENT FACILITY (LMF) 


The following types of sotiwate have license keys: 
VMS operating system 
— Separate license for each VMS member 
System integrated products (SIPs) 
—  \VAxcluster software 
—  DECnet VAX software 
Endnode (DVNETEND) 
Router (DVNETRTG) 
— VMS Volume Shadowing 


« Other layered products 
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MANAGING PRODUCT LICENSES 


Most Digital products now require a license key to be installed to operate VMS Version 5.0 
and later systems. 


Install the key by copying information from a paper product authorization key (PAK). You enter 
product keys into a cluster-wide database. 


Overview of the License Management Facility (LMF) 
As each node is started up, licenses are loaded into a volatile LMF database in memory. 


¢ Products on any node in the cluster check the volatile database to determine whether a 
particular use of the product is licensed or not. 


e There are two basic types of licenses: 
— Availability license: Allows the use of a product on a host 


— Activity license: Allows a specific number of concurrent users to access a product 


Products can also be grouped together under a single license so that a single key will enable 
the use of several products. 
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Components of the LMF 

Components of the LMF include: 

- The LICENSE database 
— Holds all information about keys. The database is managed by the LICENSE utility. 
— SYS$COMMON;SYSEXE]LMF$LICENSE.LDB is the default location. 


— lf there is more than one system disk in the cluster, the logical name LMF$LICENSE 
should point to a single database for the cluster containing all product licenses for all 
cluster hosts. This can be defined in SYLOGICAL.COM. 


— lf there is no disk accessible to all hosts, separate databases should be maintained 
identically. 


¢ To invoke the license management utility, type: 


$ LICENSE subcommand parameter 


The license management utility (LICENSE) is a DCL-level interface to the license 
management facility (LMF) on the VMS operating system. 


* SYS$UPDATE:VMSLICENSE.COM 


— Acommand procedure to assist you in registering your keys in the LICENSE database. 
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License Units 


The following list defines the concept of license unit: 


Element that specifies how much product use a license authorizes. 
Number of individual units purchased with any license is specified by the license key. 
Each processor has a series of license unit requirements. 


Products query the LMF to determine if there are sufficient units available to activate the 
product. 


Activity Licenses 


An activity license defines the number of concurrent users allowed for a product at one time. 


The user can be anywhere in the cluster. 

Different hosts may require different numbers of units per user. 

As each user activates the product, the number of available units decreases. 
If there are not enough available units, that user gets an error message. 


When a user stops using the product, the units they were using become available. 
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Table 6—1 shows the values for activity licenses on several different processors. 


Table 6-1 Values for an Activity License LURT 
Number of License Units 


VAX Model Required per User 
VAX 8650 system 75 
VAX 8350 system 60 
VAXstation 2000 system 30 


Product Usage with Activity License in a Cluster 


As an example, say a product called QUERY has an activity license for 1000 units in a cluster 
consisting of: 


« VAX 8650 
¢ VAX 8350 


« Three VAXstation 2000 systems 


As each user anywhere in the cluster accesses QUERY, the number of units required per user 
by that host will be subtracted from the number of units available to all other hosts in the cluster. 


¢ Eight users on the VAX 8650 require 8x75=600 units. 

¢ Five users on the VAX 8350 at the same time require an additional 5x60=300 units. 
* This leaves only 100 units. 

¢ Allows each of the three VAXstation 2000s to have one user of QUERY. 


¢« The next user anywhere in the cluster would receive an error message. 
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The License Management Utility (LICENSE) 


LICENSE is a DCL-level interface to the license management facility (LMF) on the VMS 
operating system. The following format is used to invoke the LMF: 


$ LICENSE subcommand parameter 


To use the license management utility (LICENSE), enter the LICENSE command and the 
desired LICENSE subcommand and qualifiers at the DCL prompt ($). 


The command procedure SYS$UPDATE:VMSLICENSE.COM eliminates much of the typing 
needed for the LICENSE REGISTER and LICENSE AMEND commands. 


Privileges Needed to Use LICENSE: 


* Most LICENSE commands require only the privileges needed to access the LICENSE 
database. 


— Normal VMS file protection applies. 


— The LMF provides the database with a default file access of read and write privileges 
to system-level processes (S:RW). 


¢ The LICENSE START, LICENSE LOAD, and LICENSE UNLOAD commands need the 
following privileges: 


— CMKRNL 
— SYSNAM 
— SYSPRV 


LICENSE LOAD and LICENSE UNLOAD let you load and unload licenses cluster-wide. 


SYSMAN> LICENSE LOAD product [/DATABASE=filespec] [/PRODUCER=string] 
SYSMAN> LICENSE UNLOAD [product] [/PRODUCER=string] 
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LICENSE Subcommand Overview 


Table 6-2 LICENSE Subcommands 


Command 
AMEND 
CANCEL 


CREATE 
DISABLE 
ENABLE 


ISSUE 


LIST 


LOAD 


MODIFY 


REGISTER 
START 


UNLOAD 


Function 


Changes a license currently in the LICENSE database 


Specifies a new termination date for a product currently in the 
LICENSE database 


Creates a LICENSE database with no license records 
Disables an existing license in the LICENSE database 


Enables an existing license in the LICENSE database so it can be 
activated with the LICENSE LOAD command 


Produces a replica of a PAK that is sent to a file or displayed on your 
terminal (the default). This command disables the license in the 
database. 


Displays information from the LICENSE database about the specified 
license or licenses 


Activates a license or licenses making them available for product 
authorization for the current node 


Modifies a license for system management and license sharing 
purposes 


Adds a new license to the LICENSE database 


Sets up an in-memory table for your system, and activates all licenses 
that are registered and enabled in the LICENSE database 


Deactivates a license, making the product unavailable from the 
current node 
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Example 6—1 shows a sample product authorization key. 


Example 6-1 Product Authorization Key 


; tt ttt dot LICENSE SOFTWARE PRODUCT | DOCUMENT ISSUE DATE | 
[dlifg{iltlall] PRODUCT AUTHORIZATION KEY | O9-MAY-1991 i 


(ee aes (Oe ee ae | | 
Digital Equipment Corporation 
Maynard, MA. 


LICENSE ADMINISTRATION LOCATION; | ORDERED BY: Newton Scientific Inst. 
Mr. Isaac Newton 

128 Main St. 
Newton, MA 03300 


Digital Equipment Corporation 
Maynard, Massachusetts 


| 
| 
| 
| 
| 
| 


KEKKKK KKK KKK KK KKK KKK KE KKK KEK KKK KKK KE KK KE KK KEK KKKKE KR KKK KK KK KKK KEK KEK KKK KKK KKK KE KKKKE KEKE 
PAK ID: 
Issuer: DEC 
Authorization Number: USA000877 


PRODUCT ID: 
Product Name: FORTRAN 
Producer: DEC 


NUMBER OF UNITS: 
Number of units: 5000 


KEY LEVEL: 
Version: 5.4 
Product Release Date: 18-APR-1991 


KEY TERMINATION DATE: 
Key Termination Date: 


RATING: 
Availability Table Code: F 
Activity Table Code: 


MISCELLANEOUS: 
Key Options: MOD UNITS 
Product Token: = 
Hardware-Id: 
Checksum: 1-CCLB-MNBO-KNNG-CBEH 


KKEKKKKKKKKKKKEKKEK EK KEK RK KKKKK KKK KKK RK KEKE KEKE KERR KKEKRE RRR KEKE KE RKREKKKKKKKKKKKKKRKKEK 
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Example 6-2 shows a sample VMSLICENSE session. 


Example 6-2 VMSLICENSE Session 


$ SET DEFAULT SYSSUPDATE 
$ @VMSLICENSE .COM 


VMS License Management Utility Options: 


1. Register a Product Authorization Key 
2. Amend an existing Product Authorization Key 
3. Cancel an existing Product Authorization Key 
4. List Product Authorization Keys 
5. Modify an existing Product Authorization Key 
9. Exit this procedure 
Type ‘'?’ at any prompt for a description of the information 
requested. 
Enter one of the above choices [1]: l 


Do you have your Product Authorization Key? [YES]: y 


The REGISTER option allows you to add a new license to a license 


database. 


A Product Authorization Key (PAK) provides the product 
name and information you need to register the license. 


You must 


enter all the information provided by your PAK exactly as specified. 


PAK ID: 
Issuer 
Authorization Number 


PRODUCT ID: 
Product Name 
Producer 


NUMBER OF UNITS: 
Number of Units 


KEY LEVEL: 
Version 
Product Release Date 


KEY TERMINATION DATE: 
Key Termination Date 


RATING: 
Availability Table Code 
Activity Table Code 


[DEC] : 
{]: USA000877 


[]: FORTRAN 
[DEC] : 


{[]: 5000 


5.4 
18-APR-1990 


Ls 
[]: 


{}s 


Che: 
[Is 
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Example 6-2 VMSLICENSE Session (Cont.) 


MISCELLANEOUS: 


Key Options []: MOD_UNITS 
Product Token []: 
Hardware-Id []: 
Checksum []: 1-CCLB-MNBO-KNNG-CBEH 


License Database File: SYSSCOMMON: [SYSEXE] LMFSLICENSE.LDB 
Issuer: DEC 
Authorization: USA000877 
Producer: DEC 
Product Name: FORTRAN 
Units: 5000 
Date: 18-APR-1990 
Version: 5.4 
Termination Date: 
Availability: F 
Activity: 
Options: MOD_UNITS 
Token: 
Hardware ID: 
Checksum: 1-CCLB-MNBO-KNNG-CBEH 


Is this information correct? [YES]: 
Registering FORTRAN license in SYSSCOMMON: [SYSEXE] LMFSLICENSE.LDB... 


Do you want to LOAD this license on this system? [YES]: 
%$LICENSE~I-LOADED, DEC FORTRAN was successfully loaded with 5000 units 


VMS License Management Utility Options: 


1. Register a Product Authorization Key 
<other options omitted from this listing> 


9. Exit this procedure 


Enter one of the above choices [1]: 9 


$ 


LICENSE MANAGEMENT FACILITY AND LICENSE AGREEMENTS 


The terms and conditions of your product contract determine your legal 
use of software. The LMF is a management tool that can help you comply 
with your license agreement. However, the LMF offers options for many 
kinds of license agreements. Using some of these options can be illegal for 
your specific contract. You must read your contract carefully to determine 
which LMF options you can use legally. 


For more information on your legal responsibilities, contact your Digital 
representatives. 
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INSTALLING LAYERED PRODUCTS 


Adjusting User Privileges and Quotas 


For a user to use a layered product, you may need to modify their user account privileges or 
quotas. User account privileges and quotas are stored in the file SYSUAF.DAT. You use the 
Authorize utility to verify and change user account privileges and quotas. To use the Authorize 
utility, set your default directory to SYS$SYSTEM and enter the DCL RUN command as follows: 
$ SET DEFAULT SYS$SYSTEM 


$ RUN AUTHORIZE 
UAF> 


At the Authorize utility prompt (UAF>), to check a particular account, enter the SHOW command 
with an account name. For example: 


UAF> SHOW SMITH 
To change a privilege or quota, enter the MODIFY command in the following format: 
MODIFY account-name/PRIVILEGE=privilege-name/quota-name=nnnn 


The following example adds the NETMBxX privilege, modifies the BYTLIM quota for the SMITH 
account, and exits the utility: 


UAF> MODIFY SMITH /PRIVILEGE=NETMBX /BYTLIM=16384 
UAF> EXIT 


After you exit the utility, the VMS operating system displays messages indicating whether or not 
changes were made. Once you have made the changes, users must log out and fog in again 
for the new privileges and quotas to take effect. 


Whenever a new account is created, its characteristics come from the DEFAULT account except 
for the ones that you specify. To change a limit or quota for any future accounts, modify them 
in the DEFAULT account that exists in every SYSUAF.DAT file. 
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Quotas and Resource Limits 


Table 6-3 AUTHORIZE Qualifiers for Quota Fields 


Qualifier 
/ASTLM=value 


/BIOLM=value 


/BYTLM=value 


/CPUTIME=time 


/DIOLM=value 


/ENQLM=value 
/FILLM=value 


/ITQUOTA=value 


/MAXACCTJOBS=value 


/MAXDETACH=value 


/MAXJOBS=value 


/PGFLQUOTA=value 


/PRCLM=value 


/PRIORITY=value 


/SHRFILLM=value 


/TQELM=value 


/WSDEFAULT=value 


/WSEXTENT=value 


/WSQUOTA=value 


Function 


Number of ASTs the user can have queued at any one time 


Maximum number of buffered I/O operations the user can have 
outstanding at any one time 


Maximum number of bytes of nonpaged system dynamic memory 
that the user’s job may consume at any one time 


The maximum CPU time a user’s process can take per session, 
specified as a delta-time value 


Maximum number of direct I/O operations (usually disk) that the 
user can have outstanding at any one time 


Maximum number of locks that can be queued at any one time 
Maximum number of files that can be open at one time 


The initial maximum number of bytes with which the job-wide 
logical name table is to be created 


Maximum number of batch, interactive, and detached processes 
that may be active at any one time for all users of the account. 
The default value of 0 represents an unlimited number. 


Maximum number of detached processes allowed at any one time 


Maximum number of batch, interactive, detached, and network 
processes that may be active at any one time 


Maximum number of pages the user’s process can use in the 
system paging files 


Maximum number of subprocesses that can exist at one time for 
the user’s process 


The default base priority for all processes created by the user 


Maximum number of shared files the user may have open at any 
one time 


Total number of entries in the timer queue, plus the number of 
temporary common event flag clusters the user can have at any 
one time 


The number of pages in the user’s default working set 
The number of pages in the user’s working set extent 
The number of pages in the user’s working set quota 
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Adjusting SYSGEN Parameters 


Some installation guides may specify that you must ensure that you have a certain number of 
GBLPAGES (global pages) and GBLSECTIONS (global sections) on your system. You do this 
as follows: 

1. Invoke the Install utility by typing 


$ INSTALL 


2. Display the existing global sections already known to VMS by typing 


INSTALL> LIST /GLOBAL/SUMMARY 
The Install utility then lists the following: 
¢ The number of global sections used 


¢ The number of global pages used and unused 


Type CTRL/Z to exit the Install utility 
Example 6-3 illustrates the output from the LIST/GLOBAL/SUMMARY command. 


Example 6-3 Displaying the Existing Global Sections 


$ INSTALL 
INSTALL> LIST/GLOBAL/SUMMARY 


Summary of Local Memory Global Sections 
279 Global Sections Used, 23722/278 Global Pages Used/Unused 


INSTALL> “Z 


3. Display the existing number of available global sections and global pages by typing: 


$ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> USE CURRENT 
SYSGEN> SHOW GBLSECTIONS 
SYSGEN> SHOW GBLPAGES 
SYSGEN> EXIT 


The system responds with data on global sections and global pages. The current maximum 


number of global sections and pages is the first number given in the respective system 
response. 
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Example 6-4 illustrates the output from the SYSGEN> SHOW GBLSECTIONS and GBLPAGES 
commands... | 


Example 6-4 Displaying the Available Global Sections and Pages 


S RUN SYSS$SYSTEM: SYSGEN 
SYSGEN> USE CURRENT 
SYSGEN> SHOW GBLSECTIONS 


Parameter Name Current Default Min. Max. Unit Dynamic 


GBLSECTIONS 340 250 60 4095 Sections 
SYSGEN> SHOW GBLPAGES 


Parameter Name Current Default Min. Max. Unit Dynamic 


GBLPAGES 24000 10000 512 -1 Pages 
SYSGEN> EXIT 


Compare these numbers with the numbers currently used, as shown in step 2 of the Install 
utility. If fewer than the required number of global pages or global sections remain, you should 
increase the number of available global sections or pages as follows: 


* Edit the file SYS$SYSTEM:MODPARAMS.DAT by adding or modifying the applicable lines 
indicated below (n and m are, respectively, the total number of global sections and global 
pages required for the new images added): 


ADD-GBLSECTIONS=n 
ADD-GBLPAGES=m 


* Invoke the AUTOGEN utility to update the GBLSECTIONS and GBLPAGES parameters: 


$ @SYSSUPDATE:AUTOGEN SAVPARAMS REBOOT 
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Table 6-4 Commonly Set SYSGEN Parameters 


Parameter Function 

GBLPAGES Establishes the size of the global page table and the limit for the 
total number of global pages that can be created 

GBLSECTIONS Determines the maximum number of global sections that can be 


made known to the system by allocating the necessary storage 
for the GST entries 


VIRTUALPAGECNT Determines the total number of pages that can be mapped for a 
process, which can be divided in any fashion between PO and P1 
space 
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Example 6-5 illustrates how to install VAX FORTRAN using the VMSINSTAL command 
procedure. : | 


Example 6-5 Using the VMSINSTAL Command Procedure to Install VAX FORTRAN 


$ @SYSSUPDATE : VMSINSTAL FORTO50 MUAO: 
VAX/VMS Software Product Installation Procedure V5.4 


It is 14-OCT-1991 at 12:11. 
Enter a question mark (?) at any time for help. 


* Are you satisfied with the backup of your system disk [YES]? |RETURN 


The following products will be processed: 
FORT V5.4 


Beginning installation of FORT V5.4 at 12:12 


SVMSINSTAL-I-RESTORE, Restoring product saveset A... 
SVMSINSTAL~I-RELMOVED , The product’s release notes have been successfully 
moved 


Product: FORTRAN 
Producer: DEC 
Version: 5.4 


Release Date: 1-FEB-1990 
* Does this product have an authorization key registered and loaded? YES 
* Do you want to purge files replaced by this installation [YES]? [RETURN] 
* Do you want to install the VAX FORTRAN compiler [YES]? [RETURN] 


This kit contains an Installation Verification Procedure 

(IVP) to verify the correct installation of the VAX 

FORTRAN compiler. The IVP will be left in: 
SYSSSYSROOT: [SYSTEST. FORTRAN] FORTRANSIVP.COM. 

After the installation is complete, you can invoke the 

command file at any time to reverify that VAX FORTRAN is 

installed and working correctly. 
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Example 6-5 Using the VMSINSTAL Command Procedure to Install VAX FORTRAN 
(Cont.) | 


* Do you want to run the IVP after the installation [YES]? |RETURN 


This kit contains a file summarizing the new features, 
changes, restrictions, and compatibility issues in this 
release of VAX FORTRAN. The name of this file is 
FORTO50.RELEASE NOTES and it is placed in SYSSHELP:. 


This file contains information valuable to VAX FORTRAN 
programmers. Please inform your user community of this 
file’s existence. 


This kit also contains the file, FORTRANFIXESO50.MEM, 
summarizing the bug fixes made to the VAX FORTRAN 
compiler since its last release. This file will be 
placed in SYSSHELP:. 


* Would you like a copy of it printed now? [NO]? |RETURN 


In order to build your FORSYSDEF library, this procedure 
requires at least 6000 blocks of available disk space, 
most of which is used for temporary work files. The 
FORSYSDEF library itself will take approximately 1900 
blocks of disk space upon completion of this procedure 
and will be placed in your SYSSLIBRARY area. 


NOTE 


Before installing FORSYSDEF, be sure to have read the 
appropriate section of the installation guide which 
addresses the question of when a new FORSYSDEF should 
be built. 


* Do you want to build a new FORSYSDEF.TLB [NO]? YES 
* Do you want to install FORTRAN help [YES]? |RETURN 


This kit contains two separate HELP files, a large 
version (approximately 600 blocks) including information 
on FORTRAN language features, and a smaller version 
(approximately 100 blocks) describing only the FORTRAN 
command. 
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Example 6—5 Using the VMSINSTAL Command Procedure to Install VAX FORTRAN 
-(Cont.) : : | 


* Do you want to install the larger version of FORTRAN help [YES]? | RETURN 


All questions regarding the installation of VAX FORTRAN 
have now been asked. Depending upon your configuration, 
time estimates for the installation(s}) have been provided. 


VAX FORTRAN compiler: 3 to 60 minutes 
FORSYSDEF.TLB: 10 to 120 minutes 
FORTRAN HELP: 1 to 15 minutes 


S$VMSINSTAL-I-SYSDIR, This product creates system disk directory VMISROOT: [SYST 
EST.FORTRAN 
%CREATE-I-EXISTS, VMISROOT: [SYSTEST.FORTRAN] already exists 


fern nn ne - --- - - -  - - - - - - - - - - -- = - 5 = $$ = = = -- = + = + 
| Installing the VAX FORTRAN V5 Compiler | 
fonn nnn ee = + 
$--------~-------- -- + + -- $e - + 
| Installing FORSYSDEF.TLB | 
fooee ne +--+ = 5-5 $5 -- = = + 
fanee-------- -- -- + = = - + + == 5 - === + 
| Installing VAX FORTRAN HELP | 
fo ~--- + 


Your VMS system will now be updated to include the 
following new and modified file(s): 


SYSSHELP:FORTO50.RELEASE NOTES [new] 


SYSSSYSTEM: FORTRAN. EXE [new] 
SYSSMESSAGE : FORTERR1 . EXE [new] 
SYSSMESSAGE : FORTERR2 . EXE [new] 
SYSSLIBRARY : FORTVSCLD.CLD [new] 
SYSSLIBRARY : DCLTABLES . EXE [modified] 
SYSSHELP : FORTRANFIXES050. MEM [new] 
SYSSTEST: FORTRANSIVP .COM [new] 
SYSSLIBRARY : FORSYSDEF .TLB [new] 
SYSSTEST: FORSYSDEFTST.COM [new] 
SYSSHELP : HELPLIB.HLB [modified] 


SVMSINSTAL~I-MOVEFILES, Files will now be moved to their target directories... 


| Verification Command Procedure for { 
| VAX FORTRAN | 


VAX FORTRAN V5.4-34 TEST PASSED 
VMSINSTAL procedure done at 12:36 
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Suppose you would like to copy the layered product kit to a disk for later installation. 


Example 6-6 illustrates how you would use VMSINSTAL to transfer a layered product kit from 
a magnetic tape to a disk. 


Example 6-6 Using the VMSINSTAL Command Procedure to Make a Copy of a Layered 
Product Kit 


$ @SYSSUPDATE:VMSINSTAL * MUBO: OPTIONS G $1SDUA1:[MOPPET] - 
_$ "/VERIFY/LOG/CONFIRM" 


VAX/VMS Software Product Installation Procedure V5.4-1P 
It is 13-JUN-1991 at 09:09. 
Enter a question mark (?) at any time for help. 


Please mount the first volume of the set on MUBO:. 
* Are you ready? y 


SMOUNT-I-MOUNTED, MESO23 mounted on _BROWNYSMUBO: 


The following products will be processed: 
MESS V2.3 


SVMSINSTAL-~I~CREATEDIR, Creating temporary directory _$1SDUA1: [MESWORK] . 


Because VMSINSTAL does not know how many save sets comprise a software 
product, it will simply copy as many as it can find. Do not be 
concerned about error messages from BACKUP after all save sets have 
been copied. 


Getting save sets for MESS V2.3 

SVMSINSTAL-I-RESTORE, Restoring product save set A 
_§1S5DUA1: [MESWORK] KITINSTAL.COM; 12, copy? (Y or N): y 
_$1SDUA1: [MESWORK]MESSAGE.CLD;1, copy? (Y or N): y 
_$1$DUA1: [MESWORK]MESSAGE INSTAL.COM;11, copy? (Y¥ or N): y 
_S$1SDUA1: [MESWORK] MESSAGE SETUP.COM;2, copy? (Y or N): y 
SBACKUP-S-COPIED, copied _$1SDUA1: [MESWORK]KITINSTAL.COM;12 
%BACKUP-S-COPIED, copied _$1SDUA1: [MESWORK]MESSAGE.CLD; 1 
%BACKUP-~S-COPIED, copied _$1$DUA1: [MESWORK]MESSAGE_INSTAL.COM;11 
SBACKUP-S-COPIED, copied _S1S$DUA1: [MESWORK]MESSAGE SETUP .COM; 2 
S*BACKUP-I-STARTVERIFY, starting verification pass 
SBACKUP-~S-COMPARED, compared _$1SDUA1: [MESWORK]KITINSTAL.COM;12 
SBACKUP-S-COMPARED, compared _$1SDUA1: [MESWORK] MESSAGE .CLD;1 
SBACKUP—-S-COMPARED, compared _$1SDUA1: [MESWORK]MESSAGE INSTAL.COM; 11 
%SBACKUP-S-COMPARED, compared _$1SDUA1: [MESWORK]MESSAGE_ SETUP .COM; 2 
SVMSINSTAL-I-RESTORE, Restoring product save set B 
$1SDUA1: [MESWORK]MESSAGE.OPT;8, copy? (Y or N): y 
$1SDUA1: [MESWORK]MESSAGE.OBJ;1, copy? (Y or N): y 
_$1$DUA1: [MESWORK] VAX_MESSAGE. OLB; 21, copy? (Y or N): y 
SBACKUP-S-COPIED, copied _$1SDUA1: [MESWORK]MESSAGE.OPT; 8 
SBACKUP-S-COPIED, copied _$1SDUA1: [MESWORK] MESSAGE .OBJ;1 
SBACKUP-S-COPIED, copied _$1S5DUA1: [MESWORK] VAX_MESSAGE.OLB; 21 
SBACKUP-I-STARTVERIFY, starting verification pass 
SBACKUP-S-COMPARED, compared _$1SDUA1: [MESWORK] MESSAGE .OPT; 8 
SBACKUP-S-COMPARED, compared _$1S$DUA1: [MESWORK] MESSAGE .OBJ;1 
SBACKUP-S-COMPARED, compared _$1SDUA1: [MESWORK] VAX_MESSAGE.OLB; 21 
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Example 6-7 Using the VMSINSTAL Command Procedure to Make a Copy of a Layered 
-Product Kit (Cont.) : 


SVMSINSTAL-I-RESTORE, Restoring product save set C ... 


SBACKUP-F-OPENIN, error opening MUBO: [000000]MES023.C; as input 


-SYSTEM-W-NOSUCHFILE, no such file 
SVMSINSTAL-E-NOSAVESET, Save set C cannot be restored. 


A total of 2 save sets copied for MESS V2.3 
VMSINSTAL procedure done at 09:15 


$ 

$ DIRECTORY 

Directory $1SDUA1: [MOPPET] 

MESO023.A;1 MESO23.B;1 SUMMARY . LOG; 1 


Total of 3 files. 
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VMSINSTAL Installer’s:Options Overview 


Table 6-5 VMSINSTAL Options 


Option 
A 


AWD 


Function 


The auto-answer option makes it easier to reinstall a product by 
providing responses to VMSINSTAL questions and prompts during 
the reinstallation. The auto-answer option is used most often for 
reinstalling products after a system is upgraded. 


The alternate working device option lets you specify an alternate 
working device for the temporary working directory. This option 
enables you to perform an installation with fewer free blocks on the 
VMI$ROOT device than is otherwise required. 


The GET save set option is used to copy the product kit save sets into 
a disk directory or other storage device for later installation. When 
option G is selected, all kit save sets are copied, but no installation is 
performed. 


The file log option is used to log all file activity to the controlling 
terminal during installation. File activity is defined as any action that 
alters the disposition of a file, such as creating a new file, updating a 
library, or deleting a file. 


The release notes option is used to display or print the release notes 
file supplied by the layered product. 


The alternate root option is used to install the product in a system root 
other than that of the running system. This option makes it possible 
to test a new product without disturbing the running system. 
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INSTALLING LAYERED PRODUCTS ON A COMMON 


SYSTEM DISK 


The standard precautions for product installation hold also for VAXcluster systems. For most 
products, the only concerns that may require more careful attention are SYSGEN parameters 
and licensing. 


* — Install layered products as in a nonclustered environment. 
¢ Perform the actual installation (the documented procedure) once for each system disk. 
¢ Edit MODPARAMS.DAT to add required number of global pages and sections. Either edit 


the cluster common MODPARAMS.DAT file or the MODPARAMS.DAT file on each node in 
the cluster. 
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After installation: , | 
¢ Create product-specific files in the SYS$SPECIFIC directory on each node, if necessary. 
— VMSINSTAL will tell you if you have to create a directory in SYS$SPECIFIC. 
- Modify any files in SYS$SPECIFIC on each node that the procedure told you to modify. 
« Reboot each node to ensure that: 
— The node is set up to run the product correctly 
— The node is running the latest version of the product 


¢ Manually run the installation verification procedure (IVP), if you did not run it during the 
installation procedure. 


— Run it from at least one other node in the cluster, preferably from all nodes. 


— lf VMSINSTAL deletes the IVP, you may be able to restore it with the following 
command procedure: 


S$ @VMSINSTAL product source device OPTIONS G device: [directory] 
$ BACKUP device: [directory] product.A/SELECT=KITINSTAL.COM device: [directory] 
$ @device: [directory]:KITINSTAL VMI_IVP 


Do not use search lists when creating files: 
« Use SYS$SPECIFIC or SYS$SCOMMON instead of SYS$SYSROOT 
* Use SYS$SPECIFIC:[SYSEXE] or SYS$COMMON:[SYSEXE]) instead of SYS$SYSTEM 
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SUMMARY 


* Once the VMS operating system is installed, you can install other optional (layered) 
software products. VMS provides a tool called VMSINSTAL to help you install most layered 
products. 


¢ To run a layered product you must purchase a license which comes in the form of a product 
authorization key (PAK). It is recommended that you install the PAK using the license 
management facility (LMF) before installing the product. 


¢ You may need to modify a user’s quotas or resource limits to enable them to use the 
layered product. 


* System parameters may need to be adjusted to install the layered product. 
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APPENDIX - LICENSE UTILITY SUBCOMMANDS 
AMEND 


¢« Amends a license currently in the LICENSE database. 


« Use the LICENSE AMEND command only when the software vendor provides amendment 
information. (Currently, Digital does not issue amendments to licenses.) 


« Use the LICENSE MODIFY command for all other changes to a license. 


Format: LICENSE AMEND product-name 


Example: 


$ LICENSE AMEND GIZMO /PRODUCER=DEC /ISSUER=DEC - 
_§S /AUTHORIZATION=USA4321 - 
_S /CHECKSUM=1~-GEAD-OODA-HIDN-PLAC /VERSION=9.3 


This command amends the license for the Digital software product named GIZMO. Entering 
this command upgrades an existing GIZMO license to Version 9.3. The producer name, issuer 
name, authorization number, and checksum number are typed exactly as they appear in the 
amendment information. | 


CANCEL 


Specifies a new termination date for a product currently in the LICENSE database. 
You must use the /TERMINATION=date qualifier. 


Format: LICENSE CANCEL /TERMINATION=date product-name 
Example: 


$ LICENSE CANCEL/AUTHORIZATION=USA1776 - 
_§ /TERMINATION=04-JUL-1990 VAX-VMS 


Unless an earlier termination date exists, this command sets a new cancellation date of July 4, 
1990 for the license on the VMS system. 


Note that the product name is entered with a hyphen (-) character as it was specified on the 
PAK. 
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COPY 


Copies one or more licenses from one LICENSE database to another. When you use the 
LICENSE COPY command, LMF disables the source license and registers a copy in the 
destination license database as if it were a new license. If the terms and conditions of your 
license contract allow it, you can reenable the source database license by using the LICENSE 
ENABLE command. 


The LICENSE COPY command cannot be used to create a copy of a license in the same 
database as the source of the copy. 


Format: LICENSE COPY product-namef,...] output-database 
Example: 


$ LICENSE COPY FORTRAN BACKUP_DATA:BACKUP.LDB 


CREATE 

Creates a LICENSE database with no license records. LMF creates a default LICENSE 
database in SYS$COMMON.:[SYSEXE]LMF$LICENSE.LDB. Therefore, you need not specify 
this command. 

Format: LICENSE CREATE 

Example: 


$ LICENSE CREATE/DATABASE=SYSSMANAGER: LMFSLICENSE.LDB 
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DELETE 


Deletes one or more licenses and all history information for those licenses from the LICENSE 
database. Deleted licenses are no longer available to the system for any use. 


Format: LICENSE DELETE product-name 
Example: 


$ LICENSE DELETE FORTRAN, COBOL, PASCAL 


DISABLE 


Disables an existing license in the LICENSE database. A disabled license cannot be activated 
to authorize product use. The LICENSE DISABLE command does not immediately affect 
any active processes. Active processes are affected only if you enter a LICENSE UNLOAD 
command or if the VMS system shuts down. 


Format: LICENSE DISABLE product-name 
Example: 
$ LICENSE DISABLE VAXset /PRODUCER=DEC 


This command disables the license for VAXset software, produced by Digital. Because no 
database is specified, LMF uses the default database. 


ENABLE 

Enables an existing license in the LICENSE database so that it can be activated with the 
LICENSE LOAD command. This command cancels the effect of the LICENSE DISABLE 
command. Newly registered licenses are enabled by default. 

Format: LICENSE ENABLE product-name 


Example: 


$ LICENSE ENABLE VAXSET /PRODUCER=DEC 
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ISSUE 

Produces a replica of a PAK that is sent to a file or displayed on your terminal (the default). If 
the terms and conditions of your license contract allow it, you can then enter this PAK replica in 
the LICENSE database of another processor. When you enter a LICENSE ISSUE command, 


LMF disables the license in the current LICENSE database and marks the license ISSUED. To 
enable a license that has been marked ISSUED, enter the LICENSE ENABLE command. 


Format: LICENSE ISSUE product-name 
Example: 


$ LICENSE ISSUE /OUTPUT=SYSSMANAGER:FORTRAN.PAK /PRODUCER=DEC FORTRAN 


LIST 

Displays information from the LICENSE database about the specified license or licenses. You 
can control the form, content, and location of information displayed with the /BRIEF, /FULL, 
/HISTORY, and /OUTPUT qualifiers. 

Format: LICENSE LIST [product-name] 


Example 


$ LICENSE LIST 
Press CTRL/Z to exit, use arrow keys to scroll. 


FORTRAN DEC 
COBOL DEC 
PASCAL DEC 


[End of List] 


History records are written by every command that changes any fields in a license record. 
These commands are AMEND, CANCEL, ENABLE, DISABLE, ISSUE, and MODIFY. 
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Example 6-8 LICENSE LIST/FULL/HISTORY Output 


$ LICENSE LIST /FULL /HISTORY FORTRAN 


Press CTRL/Z to exit, PF3-PF4 for Previous-Next Screen and Arrow Keys to Scroll. 


License Management Facility 


LICENSE database File: 


Created on: 
Created by user: 
LMF Version: 


ART: : SYSSCOMMON: [SYSEXE] LMF SLICENSE.LDB 


17-JUN-1990 
MONET 
v1.0 


eee ee ce ee ce cee sa Ne a ee et ae ene en a me me me ee me ey me ee ce mes te ee cee ee we 


Issuer: 
Authorization: 
Product Name: 
Producer: 
Units: 
Version: 

Date: 


Termination Date: 


Availability: 
Activity: 
Options: 
Hardware ID: 


Revision Level: 
Status: 
Command: 


Modified by user: 


Modified on: 
Include: 


Issuer: 
Authorization: 
Product Name: 
Producer: 
Units: 
Modified Units: 
Date: 

Version: 


Termination Date: 


Availability: 
Activity: 
Options: 
Hardware ID: 


Revision Level: 
Status: 
Command: 


Modified by user: 


Modified on: 
[End of List] 


DEC 

USA-2468 

FORTRAN 

DEC 

2000 

V4.7 

(none) 

10-DEC-1990 

F (Layered Products) 
0 


2 
Active 
AMEND 
DEGAS 


19-JUN-1990 14:32:23.41 


ART 


DEC 
USA-2468 
FORTRAN 

DEC 

2000 

9999 

(none) 

V4.5 
20-JUN-1990 
F (Layered Products) 
0 

MOD UNITS 


1 
History 
AMEND 
DEGAS 


29=JUN=1990 1231252733 
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LOAD 


Activates a license or licenses making them available for product authorization for the current 
node. The product license or licenses must currently exist and be active in the LICENSE 
database. If the license is already loaded, the LMF returns an error message and makes no 
changes. 


To use this command you need the privilege to change mode to kernel (CMKRNL), the privilege 
to create system logical names (SYSNAM), and the system privilege (SYSPRV). 


Format: LICENSE LOAD [product-name] 
Example: 


S$ LICENSE UNLOAD FORTRAN 
$ LICENSE MODIFY/INCLUDE=MUSIC FORTRAN 
$ LICENSE LOAD FORTRAN 


Whenever a load is successful, the LICENSE utility displays a message showing the number 
of license units loaded. You can also use the DCL command SHOW LICENSE to see what 
licenses are loaded. 


MODIFY 


Modifies a license for system management and license-sharing purposes. The LICENSE 
MODIFY command changes data in the LICENSE database immediately, but the modifications 
do not affect a running system until you activate the modified license with a LICENSE LOAD 
command. 


Before using this command, refer to your software license agreement to determine whether the 
modifications you want to make are valid under the terms of the license. 


Format: LICENSE MODIFY product-name 
Example: 


$ LICENSE MODIFY /EXCLUDE=(DANCE,THEATR) - 
_$ /COMMENT="Modified to exclude nodes DANCE & THEATR 6/23/90" - 
_$ FORTRAN 
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MOVE 


Moves one or more licenses from one LICENSE database to another. When you use the 
LICENSE MOVE command, LMF deletes the licenses in the source LICENSE database. 


Format: LICENSE MOVE product-name[,..] output-database 
Example: 


$ LICENSE MOVE FORTRAN ALT SYS2:LMFSLICENSE.LDB 


REGISTER 


Adds a new license to the LICENSE database. A product authorization key (PAK) provides the 
product name and information you need to register the license. You must enter all information 
provided by your PAK exactly as specified. 


Often the command procedure SYS$UPDATE:VMSLICENSE.COM is used to register a new 
product license. This provides a prompt-based interface to the LICENSE REGISTER command. 


Format: LICENSE REGISTER product-name 
Example: 


$ LICENSE REGISTER FORTRAN /ISSUER=DEC /AUTHORIZATION=USA-10 - 
_§$ /PRODUCER=DEC /UNITS=400 /VERSION=4.6 - 
_§ /AVAILABILITY=F /CHECKSUM=1-HIDN-INDA-COMP -DAHH 


$ LICENSE REGISTER DVNETRTG /ISSUER=DEC - — 

_$ /AUTHORIZATION=USA-15 - 

_$ /PRODUCER=DEC /UNITS=1000 /VERSION=4.0 - 

_$ /AVAILABILITY=E /CHECKSUM=1-COOD-AGON-EFIC-HING 
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START 


Sets up the license unit requirement table (LURT) for your system, and activates all licenses 
that are registered and enabled in the LICENSE database. Because the VMS operating system 
issues a LICENSE START command during system startup, you should need this command 
only if startup fails. 


To use this command, you need the privilege to change mode to kernel (CMKRNL), the privilege 
to create system logical names (SYSNAM), and the system privilege (SYSPRV). 


Format: LICENSE START 
Example: 
$ LICENSE START 


This command sets up the LURT for your system and activates all the licenses that are 
registered and enabled in the LICENSE database. 


UNLOAD 

Deactivates a license, making the product unavailable from the current node. The product 
license or licenses must be registered in the LICENSE database and must have been previously 
activated with an interactive or automatic LICENSE LOAD command. The LICENSE UNLOAD 
command has no effect on active processes. 


To use this command you need the privilege to change mode to kernel (CMKRNL), the privilege 
to create system logical names (SYSNAM), and the system privilege (SYSPRV). 


Format: LICENSE UNLOAD product-name 
Example: 


$ LICENSE UNLOAD/PRODUCER=DEC FORTRAN 


Messages 


To ensure that LMF messages are displayed through the operator’s communication facility 
(OPCOM), you must define the logical name LMF$DISPLAY_OPCOM_MESSAGE as follows: 


$ DEFINE/EXEC/SYSTEM LMFSDISPLAY OPCOM_MESSAGE TRUE 
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Reporting on User Activity 


INTRODUCTION 


This chapter presents the basic concepts used in user management. Among the topics covered 
are the steps used in collecting process information with the ACCOUNTING utility. 


OBJECTIVE 


To describe the tasks and responsibilities involved in managing users on a VMS system, a 
system and network manager should be able to use the ACCOUNTING utility to collect and 
report process information. 


RESOURCE 


¢ VMS Accounting Utility Manual 


TOPICS 


* Collecting process information with the ACCOUNTING utility 
— Using the ACCOUNTING utility to produce reports 
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COLLECTING PROCESS INFORMATION WITH THE 
ACCOUNTING UTILITY 


The VMS system accounting file, SYSSMANAGER:ACCOUNTNG.DAT: 
* Is created at system initialization 

« Records system activity 

* Records system resources used 


¢ Provides information that allows you to analyze the relationship between system activity 
and performance 


« Monitors system activity for security reasons 


Manipulate the system accounting file using the following commands: 
¢ SET ACCOUNTING 
— To close current accounting file and create a new version 
— To enable and disable the recording of specific system events 
* SHOW ACCOUNTING 
— To display a list of system events for which accounting is enabled 


¢ ACCOUNTING 


JOB_CONTROL writes records to ACCOUNTNG.DAT when the following events occur: 
« Process deletion/logout 

* Print job completion 

« Login failure 


« Batch job completion 


The contents of the accounting record include: 
¢« System resource usage 


* Identity of resource user 
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Use of the ACCOUNTING command requires read access to the input accounting file. 


The full format accounting report (Example 7—1) is generated by: 


$ ACCOUNTING /FULL /TYPE=PROCESS /PROCESS=INTERACTIVE 


Example 7-1 Accounting Record, Full Format 


INTERACTIVE Process Termination 


ee a ee ae ae a a ee ee 


Username: 
Account: 

Process ID: 

Owner ID: 
Terminal name: 
Remote node addr: 
Remote node name: 
Remote ID: 

Queue entry: 
Queue name: 

Job name: 

Final status text: 


Page faults: 

Page fault reads: 
Peak working set: 
Peak page file: 


VAL 
PERSONNEL 
212007CC 


VTA85: 


%SYSTEM-S-NORMAL, 


65489 
2383 
1500 
7226 


UIC: 
Finish time: 
Start time: 


Elapsed time: 
Processor time: 
Priority: 


Privilege <31-00>: 
Privilege <63-32>: 
Final status code: 


normal successful 


Direct I0: 
Buffered I0: 
Volumes mounted: 
Images executed: 


{PERSONNEL, VAL] 

30-APR-1991 17:46:43.23 

30-APR-1991 10:15:36.40 
0°07 231706,..83 
O 00s LLas rele 

4 

1014C000 

00000000 

00000001 


completion 


4091 
28753 
0 

379 
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Recording Accounting Information 


Recording is enabled by default when the system is started. The SET ACCOUNTING command 
controls which types of records are written to ACCOUNTNG.DAT by JOB_CONTROL. By 
default, the accounting log file records each of the following activities for all users: 


¢* BATCH - Batch job termination 

¢ INTERACTIVE - Interactive job termination 
* MESSAGE - User messages 

¢ LOGIN_FAILURE - Login failures 

¢« PRINT - Print jobs 

¢« PROCESS - Process termination 

¢« IMAGE - Image termination 

¢ NETWORK - Network job termination 

« SUBPROCESS - Subprocess termination 
¢ DETACHED - Detached job termination 


See Table 7—1 for information about using the SET ACCOUNTING command. 


Table 7-1 Recording Accounting Information 


Operation 


Enables the recording of all accounting 
information 


Disables the recording of all accounting 
information 


Enables the recording of accounting 
information selectively 


Disables the recording of accounting 
information selectively 


Closes the current accounting file and 
opens a new one 
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Command Format and Examples 


$ SET ACCOUNTING /ENABLE 
$ SET ACCOUNTING /DISABLE 


$ SET ACCOUNTING /ENABLE= (record-type[,...]) 
$ SET ACCOUNTING 
/ENABLE= (PRINT, LOGIN FAILURE) 


$ SET ACCOUNTING /DISABLE=(record-type[,...]) 
$ SET ACCOUNTING /DISABLE=(LOGIN_FAILURE) 


$ SET ACCOUNTING /NEW_ FILE 


Image Accounting 


Image accounting allows you to enable accounting for selected images when image accounting 
is disabled on the system. 


Issue the following command for each image you would like to enable image-level accounting 
for: 


$ INSTALL ADD file-spec /ACCOUNTING 


When image accounting is enabled on the system, it logs entries for all images. The 
/NOACCOUNTING qualifier has no effect when image accounting is enabled. 
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Using the Accounting. Utility to Produce Reports 
The ACCOUNTING utility reads the system accounting file and produces reports. 
Qualifiers to the DCL ACCOUNTING command control: 
¢« Accounting records to analyze 
* Details to disclose: 
— Full 
— Brief 
— Summary 


¢ Order in which to display records 


See Figure 7—1 for an illustration of a system accounting file. 
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Figure 7-1 System Accounting File 







$ 
$ SET ACCOUNTING/ENABLE 
$ 


NEW RECORDS ARE 
ADDED TO END 
OF-FILE 


SYSTEM MANAGER 


SYSTEM ACCOUNTING FILE 
SYSS$MANAGER:ACCOUNTNG.DAT 


$ 

$ ACCOUNTING- 
_$ /TYPE=PROCESS- 

_$ /PROCESS=INTERACTIVE- 
_$ /OUTPUT=LPAO: 
$ 









USER CREATES REPORT 


TTB_X0812_88 


Reporting on User Activity 7-9 


The Brief Report Format 


Suppose you have questions like: 


Did a particular user log in yesterday? If so, how many times? OR 
Which nodes did users set host from yesterday? 


You can use a brief report like Example 7-2 to get the answer. 


Example 7-2 Accounting Records, Brief Format 


$ ACCOUNTING /SINCE=27-APR-1991:07:30 /BEFORE=27-APR-1991:08:30 


Time 


Subtype 


Username 


Source 


Status 


27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 
27-APR-1991 


08:06:53 
08:09:37 
08:12:23 
08:13:48 
08:15:03 
08:20:51 
08:26:50 
08:28:10 


PROCESS 
PROCESS 
PRINT 

PROCESS 
PROCESS 
PROCESS 
PROCESS 
PROCESS 
PRINT 

PROCESS 
PRINT 

PROCESS 
PROCESS 
PRINT 


NETWORK 
NETWORK 


NETWORK 
NETWORK 
NETWORK 
INTERACTIVE 
NETWORK 


INTERACTIVE 


NETWORK 
NETWORK 
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DECNET 
DECNET 
BECKER 
DECNET 
DECNET 
DECNET 
KENT 
DECNET 
JOHNSTON 


PIANTEDOSI 


JOHNSTON 
DECNET 
DECNET 
BECKER 


20801B24 
20801AA5 
2080009B 
20801A28 
20801A29 
20801B2A 
2080182B 
20801AAC 
20201448 
20801 7AF 
20201448 
20801BAD 
208015B0 
2080009B 


HARDY 
SCDGAT 


ZEKE 
HARDY 
HARDY 
VTA270: 
SCDGAT 


PARROT 


SCDGAT 
UCOUNT 


10000004 
10000004 
00040001 
10000004 
10000004 
10000004 
10000001 
10000004 
0000002C 
10000001 
00040001 
10000004 
10000004 
00040001 


The Summary Report Format 
Suppose you wanted to answer a question like: 


How much processor time did each interactive user consume? (This is something you may 
charge for or report to management on.) 


Example 7-3 shows a Summary Accounting Report, highlighting processor usage. 


Example 7-3 Summary Accounting Report for Processor Usage 


$ ACCOUNTING /SINCE=05-JUN-1991:00:01 /BEFORE=06-JUN-1991 /TYPE=PROCESS - 
_$ /SUMMARY=USER /REPORT=PROCESSOR 


HH Username Processor 
Time 


02 OPERATOR 0 
12 MOPPET 0 00:00:03.18 
14 MOPPET 0 
19 OPERATOR 0 


How about each batch user? (You may charge a lower rate for batch users.) 


Example 7—4 shows a Summary Accounting Report, highlighting processor usage for batch 
users. 


Example 7—4 Summary Accounting Report, Processor Usage for Batch Users 


$ ACCOUNTING /SINCE=05-JUN-1991 /BEFORE=06-JUN-1991 /TYPE=PROCESS - 
_§$ /PROCESS=BATCH /SUMMARY=USER /REPORT=PROCESSOR 


Username Processor 
Time 

DUFFY 0 00:52:54.19 
JONES 0 00:00:02.99 
MARSH 0 00:02:17.20 
MORGAN 0 00:09:42.07 
MOSTEIKA 0 00:00:03.95 
OLIVETRA 0 00:07:12.78 
PARADISE 0 00:00:26.04 
REGNELL O 01:51:48.19 
ROUNDS 0 01:01:22.35 
SYSTEM 0 00:05:33.47 
WTHOMAS 0 00:19:55.15 
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ACCOUNTING Qualifiers 
‘Suppose you want to know how many print jobs a specific user printed in one day? 


Example 7-5 is a summary Accounting Report that shows how many print jobs user MOPPET 
printed in one day. 


Example 7—5 Accounting Report, Summary Print Information 


$ ACCOUNTING /SINCE=05-JUN-1991:00:01 /BEFORE=06-JUN-1991:00:01 - 
_$ /TYPE=PRINT /USER=MOPPET 


Date / Time Type Subtype Username ID Source Status 
5-JUN-1991 09:28:00 PRINT MOPPET 20203032 00000001 
5-JUN-1991 11:37:35 PRINT MOPPET 20203032 00040001 
5-JUN-1991 13:41:22 PRINT MOPPET 20203032 00000001 
5-JUN-1991 16:54:30 PRINT MOPPET 20203032 00040001 


Now suppose you wanted to know how many pages an average size print job for user MOPPET 
was? 


Example 7-6 is a full Accounting Report entry that shows the page count of one of the print 
jobs user MOPPET printed that day. 


Example 7-6 Accounting Report, Full Print Information 


$ ACCOUNTING /SINCE=05-JUN-1991:00:01 /BEFORE=06—-JUN-1991:00:01 - 
_S /TYPE=PRINT /USER=MOPPET /FULL 


PRINT Job Termination 


em es a ee ee we ene ee ee ee ee ee oe oe 


Username: MOPPET UIC: [GROUP11, MOPPET } 
Account: VMS Finish time: 5-JUN-1991 16:54:30.94 
Process ID: 20203032 Start time: 5-JUN-1991 16:49:19.37 
Owner ID: Elapsed time: 0 00:05:11.57 
Terminal name: Processor time: 0 00:00:00.00 
Remote node addr: Priority: 100 

Remote node name: Privilege <31-00>: 00000000 

Remote ID: Privilege <63-32>: 00000000 

Queue entry: 966 Final status code: 00040001 

Queue name: LPS40$SCDTST 

Job name: SYSNETII_SECURITY 

Final status text: %JBC-S-NORMAL, normal successful completion 

GETs from source: 4693 

QIOs to printer: 288 

Pages printed: 43 
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Suppose you wanted to know who has logged in to the operator’s terminal during the last few 
days? , 


Example 7—7 shows that information. 


Example 7-7 Accounting Report, Terminal information 


$ ACCOUNTING /SINCE=05-JUN-1991:00:01 /TERMINAL=OPAO: 


Type Subtype Username ID Source Status 
5-JUN-1991 02:15:41 LOGFAIL <login> 2020241F OPAO 10D38064 
5-JUN-1991 20:10:36 PROCESS INTERACTIVE OPERATOR 20204947 OPAO 00030001 
5-JUN-1991 20:24:36 LOGFAIL <login> 20204252 OPAO 10D38064 
S-JUN-1991 21:55:57 LOGFAIL <login> 2020495B OPAO 10D38064 
6-JUN-1991 00:48:35 PROCESS INTERACTIVE OPERATOR 2020475C OPAO 10010001 
6-JUN-1991 08:26:22 PROCESS INTERACTIVE STREET 20203F1D OPAO 00000001 
6-JUN-1991 08:26:49 LOGFAIL <login> 2020281F OPAO 10D38064 
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Selecting Accounting Files 


Example 7-8 shows how to select Accounting files. 


Example 7-8 Selecting Accounting Files 


$ ACCOUNTING /TYPE=PRINT 
$ 


$ ACCOUNTING /TYPE=PRINT SYSSMANAGER:ACCO_91 JUN _12.DAT 
$ 


$ ACCOUNTING /TYPE=PRINT SYSSMANAGER:ACCO_91 JUN*.DAT 


A summary of some of the qualifiers that can be used to specify Accounting Report contents 


are highlighted in Table 7-2. 


Table 7-2 Some Qualifiers Used to Specify Content of Accounting Report 


Qualifier 
/BEFOREs=time 
/SINCE=time 
/QUEUE=queue-name 
/JOB=job-name 
/ENTRY=entry-number 
/PRIORITY=priority 


/ACCOUNT=account-name 
/UIC=uic 
/USER=user-name 
/TERMINAL=terminal-name 
/PROCESS=process-type 
/TYPE=record-type 


Comments 


Selects records dated before specified time 
Selects records dated after specified time 

Name of print or batch queue 

Name of job sent to queue 

Number generated when job was entered in queue 


Base priority of user — helps to create report on all interactive 
users or ail real-time users 


Specified in UAF record 

Specified in UAF record 

Specified in UAF record 

Device name of terminal 

BATCH, INTERACTIVE, DETACHED, and others 
PRINT, LOGFAIL, PROCESS, and others 
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The qualifiers that you wou 


listed in Table 7-3. 


Id use to affect the output format of the Accounting Reports are 


Table 7-3 Qualifiers Affecting Output Format of Accounting Report 


Qualifier 
/TITLE=title 
/REPORT=item 


/SORT=item 
/SUMMARY=sitem 
/FULL 


. (OUTPUT=file-spec 
/LOG 
/REJECTED=file-spec 
/BINARY 


Comments 


Specifies text to be printed at the top of report 


includes specified items in a summary report (default is 
REPORT=RECORDS) 


Sorts records in ascending or descending order by one or 
more items 


To produce summary report, grouped by the items you specify 
in ascending order (default is USER) 


Displays all data in selected records. Do not use with /BINARY 
or /SUMMARY 


Sends the output to a specified file (default is SYSBOUTPUT) 
Displays log messages about progress of utility 
Saves records NOT selected in a file in binary format 


Produces output in binary rather than text format — useful 
for making a smaller accounting file from which to produce 
multiple reports 
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Creating an Accounting Report 


There are six basic steps in creating an accounting report, shown in Table 7—4. 


Table 7-4 Steps for Creating an Accounting Report 


Step Operation 


1 

Select an accounting 
file 

2 

Select the type of 
record to analyze 


3 

Select records to 
analyze, based 

on the contents of 
specific fields in the 
records 


4 
Sort the selected 
records 


5 
Choose the format of 
the report 


6 

Enter the appropriate 
command to produce 
the report 


Command Element 


Parameter 


Qualifier /TYPE 


Many qualifiers 


Qualifier /SORT 


Qualifiers /FULL, 
/SUMMARY, 
/REPORT 


ACCOUNTING 
command 
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Comment 


Default is 
SYS$MANAGER:ACCOUNTNG.DAT 


Default is all types 


Individual fields may be present in some 
record types and not in others 


Affects display order of records in full and 
brief formats 


Brief display is the default if no qualifiers are 
specified 


Requires read access to the accounting file 


Using ACCOUNTING in Command Procedures 
Use command procedures containing qualifiers to create accounting reports. 
Full command string: 


$ ACCOUNTING - 

_$ /SINCE=02-APR-1991:05:00 - 
_§ /BEFORE=02-APR-1991:10:00 - 
_$ /TYPE=PROCESS - 

_$ /SUMMARY=(HOUR,USER) - 

_$ /REPORT=BUFFERED_ IO 


The contents of the DCL command procedure BUFFSUM.COM is: 
/TYPE=PROCESS /SUMMARY= (HOUR, USER) /REPORT=BUFFERED IO 


Type the following to get the abbreviated command string incorporating the DCL command 
procedure BUFFSUM.COM 


$ ACCOUNTING - 
_$ /SINCE=02-APR-1991:05:00 - 
_$ /BEFORE=02-APR-1991:10:00@BUFFSUM 
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SUMMARY 


« The system accounting file is used to: 
— Record system activity 
— Charge for system resources used 
— Analyze relationship between system activity and performance 
— Monitor system activity for security reasons 
¢ The information gathered in the system accounting file is then read and formatted by the 


ACCOUNTING utility. Input and output can be controlled by the system manager with DCL 
commands. 
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Maintaining System Security 


INTRODUCTION 


This chapter presents the basic concepts of maintaining system security. Among the topics 
covered are: 


¢ The definition and identification of general system security 
¢ An introduction to VAXcluster security considerations 
¢ The conventions for using SYSGEN parameters and user quotas 


¢« The steps used in a conversational startup 
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OBJECTIVES 


To describe the tasks and responsibilities in maintaining system security, a system and network 
manager should be able to: 


¢« Describe the VMS functions that are available for general system and VAXcluster security 
¢ Assign privileges to users according to their needs 
¢ Restrict user passwords by using SYSGEN parameters and other methods 


* Perform a conversational startup 


RESOURCES 


¢« VMS Authorize Utility Manual 

« VMS DCL Dictionary 

* Guide to VMS System Security 

¢ VMS System Generation Utility Manual 

¢ Guide to Maintaining a VMS System 

* Guide to Setting Up a VMS System 

¢ VMS VAXcluster Manual 

* VMS Audit Analysis Utility Manual 

* Hardware Operations Guide for VMS Systems 


* — VMS Installation and Operations Guide 
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TOPICS 


« Physical security 
¢ Software security 
—  VAXcluster security considerations 
— File Security 
¢ Login security 
— System passwords 
— Filtering passwords 
— Password usage 
— Protecting terminals and other nonshareable devices 
— Password collection programs 
— Break-in detection at login 
— Intruder lists 
— Clearing intrusion records 
« UIC and ACL protection 
— VMS protection using UICs 
— VMS protection using ACLs 
¢ Tailoring user accounts 
— Access and security fields 
— Privileges 


* Conversational startup 
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PHYSICAL SECURITY 


Different installations require different levels of security. The system manager has control over 
the level of security implemented. | 


Security issues include: 

¢ Physical security of computer 
— Access to console terminal 
— Availability of dial-up lines 


¢« Media storage 
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SOFTWARE SECURITY 


To ensure the basic minimum security, the system manager should: 

* Keep SYSUAF.DAT, RIGHTSLIST.DAT, and NETPROXY.DAT up to date 
¢« Use flags and hourly restrictions with AUTHORIZE 

e — Insist on nontrivial passwords 

¢ Not publicize dial-up numbers 

- Not permit WORLD access to SYSUAF.DAT 

« Encourage use of file protection codes and ACLs 

¢ Restrict user activity with Captive accounts 

¢ Restrict user privileges 

* Create accounting reports to check system usage 


¢ Label disks and tapes in a systematic manner 


For additional security, the system manager can include: 
¢« Secondary passwords 

¢ Erase-on-delete and erase-on-allocate for files 

* Login security 

¢ Break-in detection 

¢ Security auditing 


¢ Alarms on files 
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VAXcluster Security Considerations 
A VAXcluster system should be treated as a single management domain. It must be managed 
as a single system, by a single system manager, or a cooperating management team. Even 


if a cluster has many different working environments, the different systems have access to 
common, shared resources and must be guided by a single security and management policy. 


¢ Privileged users on one VAX node can affect the other nodes. 

e There is no node-specific file protection by default. 
— The system manager can implement node-specific protection 
— Use a coordinated rights list and access control lists (ACLs) 


* A network can provide greater security isolation between nodes than a VAXcluster 
environment. 


* Asingle system implies that user names, UICs, and access rights are unique throughout 
the cluster. 


¢ Multiple user authorization files 
— Not recommended in most cases 
— Break the single-system model of a cluster 
— Must be kept consistent manually 


— Do not isolate privileged users 
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File Security 

Erase-On-Delete and Erase-On-Allocate 

Erase-on-delete (EOD) refers to activity of the file system when files are deleted: 
¢ File system overwrites blocks with zeros. 

¢ Blocks are unavailable for allocation until overwritten. 

« Users implement EOD on a file-by-file basis. 


¢« Managers implement EOD on a volume-by-volume basis. 


Erase-on-allocate (EOA), also known as high-water marking, refers to activity of the file system 
when files are created or extended: 


¢ File system overwrites blocks with zeros (or pattern of your choice) before allocating them. 
¢ Set automatically for each volume at initialization. 


*  For-less.security-sensitive volumes, disable high-water marking. 


 § SET VOLUME/NOHIGHWATER MARKING ~ 


NOTE 


Enabling these system qualifiers does create an increase in system 
overhead. 


Table 8—1 shows commands for setting erase-on-delete for a file or volume. 
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Table 8-1 Setting Erase-On-Delete for a File or Volume 





Command/Qualifier and Example 


$ SET FILE/ERASE_ON_DELETE - 


_S file-name 


$ SET FILE/ERASE ON DELETE - 
_$ GOVERNMENT _SECRETS. DAT 


$ DELETE/ERASE ON_DELETE - 
_$ file-name 


$ DELETE/ERASE_ON DELETE - 
_S MY_SECRETS. DAT 


$ PURGE/ERASE_ON_DELETE ~- 
_$ file-name 


$ PURGE/ERASE_ON_ DELETE - 
_$ COMPANY SECRETS. * 


$ INITIALIZE/ERASE ON DELETE - 


_$ volume-name 


$ INITIALIZE/ERASE_ON DELETE - 
_$ SECURE_VOLUME: 


$ SET VOLUME/ERASE_ON DELETE - 
_$ SECURE_VOLUME: 


8-10 Maintaining System Security 


Comments 


Sets characteristic of file so file system performs 
an EOD when you delete it 


Tells the file system to perform an EOD as you 
delete the specified file or files 


Tells the file system to perform an EOD on each 
file it deletes during the purge 


Tells the file system to perform an EOD for every 
file on this volume that users delete 


Modifies the volume’s characteristic so the file 
system now performs an EOD on every file deleted 
from it 


LOGIN SECURITY 


Each user is normally assigned a user name and a password in the authorization file, 
SYSUAF.DAT. The user must enter both (unless the password is null) before using the system. 


¢« Use the Authorize utility to set 


— Expiration date on UAF records 


— Minimum password length 


— Expiration date for password 


— Passwords that must be changed when user logs in for the first time 


¢« Can define secondary password for accounts 


« Can have the VMS system automatically provide a list of randomly generated passwords 


You can define a secondary password for some accounts with the Authorize utility, as described 


in Table 8-2. 


Table 8-2 Defining User Passwords 
Commands 


$ RUN AUTHORIZE 
UAF> MODIFY SMITH /PASSWORD=MARY 


$ RUN AUTHORIZE 
UAF> MODIFY SMITH 
/PASSWORD= (""", SECOND) 


$ SET PASSWORD 
$ SET PASSWORD/ SECONDARY 


$ SET PASSWORD/GENERATE 


Comments 


Modifies any user password with the Authorize 
utility. 

To add a secondary password to a UAF record, 
use the /PASSWORD qualifier with the MODIFY 
command. This command does not affect the 
current value of the primary password if you 
properly specify a null first password string. 


Modifies your own primary password. 
Modifies your own secondary password. 


You can request or require (using the 
/FLAG=GENPWD qualifier in Authorize) that the 
VMS system generate a random list of passwords 
to choose from. If you enter the /GENERATE 
qualifier and receive a list, you must choose a 
password from that list, or request another list. 
(You do not need the /GENERATE qualifier if 
password generation has been set in your UAF 
record.) 
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System Passwords 


For terminals in remote or sensitive locations, you can require a system password as shown 


in Table 8-3. 


¢ Can require system password for terminals 


* System password kept as a special UAF record 


« System password can be set 


— System password can be initially set and changed 


Within AUTHORIZE: UAF> MODIFY /SYSTEM_PASSWORD 


— System password can be changed subsequently 


At DCL: $ SET PASSWORD/SYSTEM 


Table 8-3 Defining a System Password for a Terminal 


Step/Function 
Step 1: 


$ SET PASSWORD/SYSTEM 
Old password: 
New password: 
Verification: 


$ 
Step 2: 
$ SET TERMINAL - 


_$ /SYSPASSWORD /PERMANENT - 
_$ TXA2 
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Comments 


Enter the old password in response to the first prompt. 
Then enter the new password in response to the next 
two prompts. None of the passwords are echoed while 
being entered. This command requires SECURITY and 
CMKRNL privileges. 


Set the specified terminal to require the system 
password. To log in to this terminal a user must press 
the RETURN key and enter the system password (no 
prompt is given). If successful, the user continues the 
normal login procedure when the Username: prompt 
appears. This command requires LOG_IO privilege. 


Password Usage 


Users and managers should be aware of password requirements for accounts and terminals. 


Tabie 8-4 Using Passwords 


Situation 


Normal account: 
requires one 
password 


Account requiring 
primary and 
secondary 
passwords 


Terminal requiring 
a system password 


Example 


RETURN 
Username: SMITH 


Password: 


RETURN 
Username: SMITH 
Password: 


Password: 


Systempassword 
RETURN 
Username: SMITH 


Password: 


Comments 


The system does not echo the password. Note 
that you can define the password to be null. If 
you do that, you do not receive any password 

prompt. 


Passwords are not echoed. Typically, one 
person knows the primary password, but 
another knows the secondary one. Therefore, 
both must be present whenever this account is 
used. : 


You do not receive a prompt for the system 
password. User must hit the break key to begin 
the login process. To avoid excessive reports 
of broken terminals, make users aware of the 
ones requiring a system password, because 
unless they enter it successfully, the system will 
not display the Username: prompt. 
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Filtering Passwords 


Filtering is a procedure for screening user-selected passwords for acceptability. Filtering is not 
on former system-generated passwords or passwords set in AUTHORIZE. 


Dictionary Search 

« New passwords are automatically checked against a system password dictionary to make 
sure the word is not present in the dictionary. 

¢ The system password dictionary is kept in SYS$LIBRARY. 


« /FLAGS=DISPWDDIC is the flag placed on user accounts (using the Authorize utility) to 
disable the dictionary search. 


History Search 


« The system keeps a list of 100 passwords used by each user and compares the new 
password with the list. 


¢ SYS$SYSTEM:VMS$PASSWORD_HISTORY.DATA is where the password history list is 


— _. stored. 


« /FLAGS=DISPWOHIS is the flag placed on user accounts (using the Authorize utility) to 
disable the history search. 
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Protecting Terminals and Other Nonshareable Devices 


Devices that are not shareable, such as terminals, have an owner UIC and a protection code 
that determine what processes can allocate the device. 


* Terminals (nonshareable devices) have owner UIC and protection code that determine 
access 
— To control device ownership and protection 


$ SET PROTECTION/DEVICE 


— To place access control list (ACL) protection on terminals and tape drives 


$ SET DEVICE/ACL 


Table 8-5 Establishing Ownership and Protection of Terminals and Other Nonshareable 
Devices 


Format of 
SET PROTECTION/DEVICE 
Command and Examples 


Operation (Requires OPER privilege) Comments 

Establishing $ SET PROTECTION=code/DEVICE- By default, ail terminals have the owner specified by 

protection ownership _$/OWNER_UIC=[UIC] device the system parameter TTY_OWNER and the protection 
specified by the system parameter TTY_PROT. 

Allowing all users $ SET PROTECTION/DEVICE device The default value for TTY_PROT allows ail users 

access to a device $ SET PROTECTION/DEVICE TTA3: access to the device. If you do not specify a protection 


code with this command, you are assigning the default 
protection to the device. 


Establishing system $ SET PROTECTION = Only system users can allocate this terminal from a 
users as the owner (S:R,0:R,G,W) - program. By specifying that Group and World users 
_§$ /DEVICE/OWNER=[1,4] TTA3: have no access, you protect the terminal against 


password collection programs run by users. 
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Password Collection Programs 


You can protect terminals from password-collecting programs by setting the secure server 
characteristic on them: 


$ SET TERMINAL/PERMANENT/SECURE_SERVER/DISCONNECT TTC1: 


Ensures that only the VMS login program receives user name and password. 


You must educate users to press the BREAK key (instead of RETURN key) to receive 
Username: prompt before logging in. 


The SECURE_SERVER characteristic has no effect on terminals with AUTOBAUD 
characteristic set. 
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Break-In Detection at Login 


When you implement break-in detection, the VMS system records information about login 


failures in suspect lists. 


« User name suspect list 


¢ Terminal name suspect list 


¢« Node name suspect list 


Several SYSGEN parameters provide break-in control, as shown in Table 8-6. 


Table 8-6 SYSGEN Parameters for Break-In Detection 


Parameter 


LGI_ BRK DISUSER 


LGI_BRK_LIM 


LGI_BRK_ TERM 


LGI_BRK_TMO 


_LGI_HID TIM 


LGI_RETRY_LIM 


LGI_RETRY_TMO 


Comments 


Once an intruder has been detected, the VMS system sets the 

DISUSER flag in the account’s UAF record (if the parameter is set 
to 1). Manual intervention by the system manager is necessary to 
reactivate the account. Use this feature with caution. Default = 0. 


Break-in limit defining the total number of consecutive login failures 
allowed within a reasonable time limit before a SUSPECT becomes 
an INTRUDER. Default = 5. 


Controls the association of terminals and user names for counting 
failures. By default, the VMS system sets this parameter to 1 so that 
terminals and user names are tracked together. If you use terminal 
servers, then you might want to set this parameter to O (only track 
user names), since a LAT port (on the VAX side) is generally not a 
useful indication of the actual terminal being used. Default = 1. 


Timeout factor expressed in seconds (a delta time). Used in 
conjunction with LG|_BRK_LIM to decide if a SUSPECT is an 
INTRUDER. The larger this value, the more secure your system. 
Default = 300. 


Time factor expressed in seconds. System uses this value in an 
equation to determine the time interval during which an INTRUDER 
is subject to evasive action. The time interval calculated using LGI_ 
HID_TIM is different for each instance, so you never know exactly 
how long an INTRUDER will be evaded. Default = (300*n) where n = 
some number between 0 and 1.5. 


Limits the number of times a user can retry the login procedure when 
coming in through dial-up lines. Default = 3. 


The number of seconds allowed between login attempts on dial-up 
lines. Default = 20. This means the user must properly log in within 
20 seconds of a failed attempt, or the system will hang up the line. 
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Suspects can gain access to the VMS system by entering the correct user name and password. 
Example 8—1 demonstrates a successful break-in. 


Example 8-1 Break-In Suspect Logs in Successfully 


@ RETURN 


2) This is node TIDE 

Username: JONES 
© Password: 

User authorization failure 
@ Username: JONES 

Password: 

User authorization failure 
6 Username: JONES 

Password: 

Welcome to node TIDE running V5.4 

@ Last interactive login on Saturday, 11-JUN-1990 08:59 
Q 2 failures since last successful login 


$ 
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Notes on Example 8-1: 


User presses the RETURN key. 
System displays the announcement message and Username: prompt. 
User enters an incorrect password and fails to log in. 


User presses RETURN again. This time the system displays no announcement message 
before displaying the Username: prompt. Two SYSGEN parameters govern whether the 
announcement message appears or not: LGI_RETRY_TMO and LGI_LRETRY_LIM. The 
value of the first parameter determines how long the system waits between retries (default 
is 20 seconds). The value of the second parameter determines how many retries are 
allowed. These parameters affect dial-up users primarily because the system breaks their 
connection after these limits are reached, forcing the user to dial in again. The on-line 
user simply presses RETURN and receives the announcement message as well as the 
Username: prompt. 


User presses RETURN, logs in successfully and receives the welcome message and two 
other messages. 


The first message tells the user when someone last logged in successfully using that user 
name and password. If this message shows a login more recent than the last time this 
user actually logged in, the user should report it as someone may have guessed the user’s 
password. 


The second message tells the user how many login attempts were made before the login 
was successful. If there is a difference between the number of failures reported and the 
number of times the user actually caused a failure, the user should report it as someone 
may be trying to break in to the system. 


Maintaining System Security 8-19 


Intruder Lists 


The VMS system creates intruder lists when login failures exceed the break-in limit, set by the 
system manager. 


* Separate intruder lists for user name, terminal name, and node name 


¢ Intruders subject to evasive action 


Example 8-2 is an example of a break-in suspect becoming an intruder. 
Example 8-2 Break-In Suspect Becomes an Intruder 


RETURN 
THIS IS NODE TIDE 


Username: WEBSTER 

@ Password: 
User authorization failure 
Username: WEBSTER 
Password: 
User authorization failure 
Username: WEBSTER 
Password: 
User authorization failure 


RETURN 
2] THIS IS NODE TIDE 


Username: WEBSTER 
Password: 

User authorization failure 
Username: WEBSTER 
Password: 

User authorization failure 
Username: WEBSTER 
Password: | 

User authorization failure 
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Notes on Example 8-2: 


The user enters an incorrect password on three login attempts and receives a user 
authorization failure message each time. 


The user presses the RETURN key and receives the announcement message again 
because the LGl_RETRY_LIM parameter is set to 3 on this system. A dial-up user loses 
the carrier after the third unsuccessful attempt. 


The user enters an incorrect password and receives an error message. If the password 
was correct, the user could still log in at this fourth attempt because the value of the 
LGI_BRK_LIM parameter on this system is 5. 


The user enters the correct password, but since this is the sixth attempt, the system begins 
evasive action. (Evasive action includes responding to correct input with error messages 
for a variable period of time.) This user name cannot be used for a while to log in. If a user 
reports being unable to enter their account even after entering the correct password, an 
intruder might be trying to break in to the system. Change the password immediately and 
read the security audit reports on the console terminal. 
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Clearing Intrusion Records 


The following example shows how to check for intrusion records, then how to delete the record 
from the intrusion database. Requires CMKRNL (Change Mode to Kernel) and SECURITY 
privileges. 


$ SHOW INTRUSION 


Intrusion Type Count Expiration Source 
TERMINAL INTRUDER 6 04:49:02.02 —_OPAO: 
TERM_USER SUSPECT 5 20:39:27.38 —_OPAO:MOPPET 

$ 

$ DELETE/INTRUSION_RECORD _OPAO:MOPPET 

$ 

$ DELETE/INTRUSION_RECORD _OPAO: 

$ 


$ SHOW INTRUSION 
SSHOW-F-NOINTRUDERS, no intrusion records match specification 
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UIC AND ACL PROTECTION 


Table 8-7 ACL- and UiC-Based Protection 


File Name and 
Owner UIC 


FILE.DAT 
[200,011] 


PROGRAM.FOR 
[200,011] 


JUNK.DAT 
[200,011] 


Type of Protection 


UlC-based protection: 
(S:RWED,O:RWED,G:RWE,W) 
No ACL set 


UiC-based protection: 
(S:RWED,O:RWED,G:RWE,W) 
(IDENTIFIER=SMITH,ACCESS=READ) 


ACL allows users holding the identifier 
name SMITH to read the file. 


UIC-based protection: 
(S:RWED,O:RWED,G:RWE,W) 
(IDENTIFIER=SMITH,ACCESS=NONE) 


ACL does not allow users holding the 
identifier name SMITH to have any access 
to the file. 


Access Allowed 


System and Owner have 
RWED access. Group 
users have RWE access. 
World users have no 
access. 


System and Owner 

have RWED access. 
Group users have RWE 
access. Users holding 
the identifier name SMITH 
have READ access only 
(even if they are in the 
Group category). Other 
users have no access. 


System and Owner users 
have RWED access (even 
those holding the identifier 
name SMITH). Group 
users have RWE access 
except those holding the 
identifier name SMITH. 
World users have no 
access. 
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VMS Protection Using UICs 

In assigning UICs to users, determine the extent to which user processes need to: 
* Share access to files, volumes, and devices 

¢ Communicate interactively with one other 


¢« Affect or control one other 


For greater interaction, place users in the same UIC group. 


For greater protection, place users in different groups. 


8-24 Maintaining System Security 


Table 8-8 suggests how to define groups based on user needs when you set up their UICs. 


Table 8-8 Dividing Users into Groups 


User Situation Course of Action 

Users must allow some users Divide users into groups along project 
access to their files and or departmental lines. Assign a different 
structures, but deny access group UIC number to each group. Leave 
to others on the system. room between each assigned number for 


additions later. 


Users do not need to protect Assign all users a UIC of [300,300] or 
files against access by each some other UIC." 

other, but you must protect 

system files from their access. 

(System files usually have a 

group number from 0-10.) 


Users need not protect files, Divide users into groups. ! 

but should divide them into Either: 

groups for accounting and 

observation purposes. 1. Modify the system parameter 


RMSFILEPROT to set the default 
protection assigned to all new files 
so WORLD has complete access. 


2. Create a LOGIN.COM file 
for each user and include 
the SET PROTECTION 
/DEFAULT=(W:RWED) command in 
it. Do not include this command in 
your LOGIN.COM file if you are the 
system manager. 


Result 


Users within a group can access each other's 
files with the access set for GROUP in the 
protection code of the accessed file. Users 
outside a group will be able to get access to 
files belonging to a group member with the 
access defined for WORLD only. 


All users own all user files and have OWNER 
access to all user files. Users cannot access 
system files. 


1. You can collect accounting information 
on separate users (according to their 
UICs) but since all files created allow 
all users complete access, the files are 
not really protected. In this case, newly 
created system files are not protected 
either. 


2. You can collect accounting information 
on separate users (according to their 
UICs). Users can access all files on the 
system except your files and system 
files. 


' Do not assign a group number reserved for system users (typically 0-10). Modify the 
MAXSYSGROUP parameter to set the upper limit of the group number for system users as needed. 
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Process Interaction 


You can increase the ability of processes to interact and share information by assigning them 
UICs in the same group. | 


You can decrease this ability by assigning them UICs in different groups. 


Table 8—9 details the effects of UIC group assignment on process interaction. 


Table 8-9 Interaction Between Processes in Same Group 
Interaction Available Comment 


Can share files, volumes, and devices, yet Accomplished by setting the protection codes of 
deny access to processes in other groups __ the files, volumes, and devices properly 


Can communicate with each other by For example: 
means of structures that processes in 
other groups cannot access * Group logical names 


¢ Group mailbox logical names 
¢ Group global section names 


¢* Common event flag clusters 


Can affect and control other processes in Requires GROUP privilege 
group 
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VMS Protection Using ACLs 


While VMS system protection using UICs is usually sufficient for most files on your system, the 
VMS operating system provides an additional layer of protection. 


Can be used to grant access to files for specific users rather than groups of users 
Based on identifiers 

— Users can hold one or more identifiers 

— Files can specify access rights for holders of various identifiers 

Record access information for files in an access control list (ACL) 

Define identifiers and who holds them in rights database 


When a user logs in, the VMS system creates an access rights list for that user, consisting 
of identifiers held 


When the user attempts to access files, the VMS system compares the access rights list of 
the user with the access control list of the file 


— Ifno ACL is on file, the VMS system determines access rights according to the UIC of 
the user and VMS protection code on file 


— lf the ACL does not allow access, SYSTEM and OWNER users can still gain the type 
of access allowed them in the VMS protection code 


— If the user does not hold any identifiers listed in the filess ACL, the VMS system 


determines access rights according to the UIC of the user and VMS protection code 
on file 
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@ Username: 


TAILORING USER ACCOUNTS 


UAF record fields fall into four basic categories: 


@ identification and environment 
@ Access and security 

© Quotas and resource limits 

@ Privileges 


Example 8—3 shows a sample listing of a UAF record and indicates the location of these field 


categories. 


Example 8-3 UAF Record Field Categories 


SMITH Owner: MARY SMITH 
Account: GRP11 UIC: [11,2] ([ADMIN, SMITH] ) 
CLI: DCL Tables: DCLTABLES 
Default: DISKSUSER: [SMITH] 
LGICMD: SYSSMANAGER:GRP11LOGIN 
@ Login Flags: Diswelcome Disnewmail 
Primary days: Mon Tue Wed Thu Fri 
Secondary days: Sat Sun 
Primary 000000000011111111112222 Secondary 000000000011111111112222 


Day Hours 012345678901234567890123 Day Hours 


012345678901234567890123 


Network; <—-==-<=+ HHEEEREER HHH em No“access -ser==— 

Bateht: “SSS sen= HHEEREEERER HMO Neo access. ‘—=S=== 

Local: ###¢# Full access ###### ##H### Full access ###### 

Dialup: © <= SesSs- HEEEREREE HHH ee No access. ==--== 

Remote:  — SSs=r-s- HHEEEEREE EHH em No access ~----- 

Expiration: (none) PWDMINIMUM: 6 Login Fails: 0 

Pwdlifetime: 90 00:00 Pwdchange: (pre-expired) 

Last Login: (none) (interactive), (none) (non-interactive) 
© Maxjobs: Q Fillm: rye 20 Bytlm: 4096 

Maxacct jobs: 0 Shrfilim: w 09 Pbyt lm: he 0 

Maxdetach: O BIOlm: 6 JITquota: 1024 

Prelm: 2 DIOlm: 6 WSdef: 1024 

Prio: 4 ASTlm: 10 WSquo: 2048 

QUEPLLO: Mymatn besy 4 TOEI1m: 10 WSextent: 4096 

CPU: “|(none) Enqlim: 10 Pgflquo: 10000 


@ authorized Privileges: 


GROUP TMPMBX NETMBX 
Default Privileges: 
TMPMBX NETMBX 
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Access and Security Fields 

Access and security fields are used to: 

« Limit the use of the account according to time/day or access mode 
¢ Limit certain capabilities once logged in to the system 


¢ Authenticate user requests for access to files and other resources 


Access Times and Modes 

You can limit an account’s access to the system in three ways: 
¢« Time of day 

¢- Day of week 


* Access mode 


For example, the following command sets the primary days to be Monday through Friday for the 
user SMITH. (The other days of the week automatically become secondary days for this user.) 


UAF> MODIFY SMITH/PRIMEDAYS= (MON, TUE, WED, THU,FRTI) 
For example, the following commands allow SMITH to gain access to the system in any manner 


from 8 a.m. through 5 p.m. except during lunch on primary days, but prevents any access on 
secondary days: 


UAF> MODIFY SMITH/ACCESS=(PRIMARY, 8-11, 13-16) 
UAF> MODIFY SMITH/NOACCESS=SECONDARY 


Table 8—11 summarizes the AUTHORIZE qualifiers used to restrict access. 


You can combine these values to further specify the account's ability to gain access to the 
system. For example, the following commands allow SMITH to use a local terminal during the 
day and a dial-up terminal during evenings and weekends. 


UAF> MODIFY SMITH/LOCAL= (PRIMARY, 8-17, SECONDARY, 8-17) 
UAF> MODIFY SMITH/DIALUP=(PRIMARY, 18-7, SECONDARY, 0-23) 


Table 8-10 lists the various types of access modes. 
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Table 8-10 Login Access Modes 


Mode Description 

INTERACTIVE Any kind of interactive login 

LOCAL Directly connected terminals 

DIALUP Modem connections using telephone services (or network services 
emulating telephone services) 

REMOTE Virtual terminal connection across DECnet system 

BATCH Batch jobs (noninteractive access method) 

NETWORK DECnet noninteractive network access, for example: file transfers, 


electronic mail to/from other nodes, and so forth. 


Table 8-11 summarizes the AUTHORIZE qualifiers used to restrict access. 


Table 8—11 AUTHORIZE Qualifiers for Access Fields 


Qualifier 


/ACCESS[=(range[,...]) 
/BATCH [=(range[,...]) 
/DIALUP[=(range{,...]) | 


/ INTERACTIVE [=(range[,...]) 
/LOCAL{=(range[,...]) ! 


/PRIMEDAYS=([NO]day[,...]) 


/NETWORK [=(range[,...]) 


/REMOTE[=(range[,...]) | 


Function 


Specifies hours of access for all modes of access 
Specifies hours of access permitted for batch jobs 
Specifies hours of access permitted for dialup jobs 


Specifies hours of access permitted for interactive 
logins 


Specifies hours of access permitted for interactive 
logins initiated on local terminals 


Specifies the primary and secondary days of the week 
for logins. Specifies primary days as MON, TUE, WED, 
THU, FRI, SAT, and SUN. Specifies secondary days as 
NOMON, NOTUE, NOWED, and so forth. 


Specifies hours of access permitted for network batch 
jobs 


Specifies hours of access permitted for interactive 
logins initiated by network remote terminals 


' These are interactive logins, so you can use the /INTERACTIVE qualifier to specify all three 


interactive access methods. 
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Login Flags 


Login flags are used to restrict certain activities of the user’s job. Table 8—12 is not a complete 
list; it lists login flag parameters that are related to security. 


Table 8-12 Login Flag Parameters Related to Security 


/FLAG Parameter ' 
AUDIT 

AUTOLOGIN 

CAPTIVE 

DEFCLI 

DISCTLY 

DISFORCE PWD CHANGE 
DISMATL 


DISPWDDIC 


DISPWDHIS 


DISRECONNECT 


- DISREPORT 


DISUSER 
DISWELCOME 
GENPWD 
LOCKPWD 

PWD_ EXPIRED 
PWD2_EXPIRED 


RESTRICTED 


Purpose 

Audits all security-relevant actions 

Restricts this account to autologins only 

Prevents user from changing any defaults at login 
Prevents user from changing default CLI or CLI table 
Disables CTRL/Y interrupts 

Disables forced user expired password changes 
Prevents Mail delivery to this user 


Disables automatic screening of new passwords against 
a system dictionary 


Disables automatic checking of new passwords against 
a list of the user’s passwords from the last year 


Disables automated reconnections 

Disables time of last login and other security reports 
Disables this account completely 

Suppresses “Welcome to...” login message 
Requires user to use generated passwords 
Prevents user from changing password 

Marks password as expired 

Marks second password as expired 


Ensures that all commands are executed in the 
system and user login command procedures and 
any procedures invoked from these two procedures 


1 Any flag can be prefixed with NO to turn off the flag’s intended purpose, for example: 


/NOLOCKPWD 


NOTE 


If your default account has the DISUSER flag set, you must add the 
/FLAG=NODISUSER qualifier when generating a new account. 
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Security Fields 


Security fields are used to authenticate user requests for access to files and other resources. 
Table 8—13 lists the qualifiers used to set these fields, as well as control the rights database. 


Table 8-13. AUTHORIZE Qualifiers for Security Fields 


Qualifier 


/ADD_IDENTIFIER 


/EXPIRATION=time 


/GENERATE_ PASSWORD [=keyword] 


/MODIFY_ IDENTIFIERS 


/PASSWORD= (pwdl1[, pwd2] ) 


/PWDEXPIRED 


/PWDLIFETIME=time 


/PWDMINIMUM=value 


/REMOVE_IDENTIFIER 


Function 


Adds identifiers for the user name and account name to 
the rights database 


Expiration date and time of the account 


Invokes the password generator to generate user 
passwords. Details of the possible keywords are 
discussed in the VMS Authorize Utility Manual. 


Specifies whether the identifier associated with a user 
record is to be modified in the rights database 


Specifies the primary and optional secondary 
passwords 


Specifies whether a password is valid only for the first 
login 


Specifies the length of time a password is valid, entered 
as a delta-time value 


Specifies the minimum number of characters allowed 
for a password 


Specifies whether the user name and account name 
identifiers should be removed from the rights database 
when the UAF record is removed from SYSUAF.DAT. 
Works only for the REMOVE command. 


Table 6—3 lists the qualifiers used to set these and other process-related parameters. 
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Example 8—4 shows how you would change a user name and its corresponding identifier while 
leaving the UIC the same. 


Example 8-4 Modifying User Name and Identifier 


S$ me authorize 
UAF> SHOW /ID MORGAN 


Name Value Attributes 
MORGAN [000300,000020] 
UAF> RENAME MORGAN BMORGAN/MODIFY_ID/PASSWORD=BMORGAN 
SUAF-I-RENMSG, user record renamed 
SUAF-I~RDBMDFYMSG, identifier MORGAN modified 
UAF> SHOW /ID BMORGAN 


Name Value Attributes 
BMORGAN [000300,000020] 
UAF> EXIT 


SUAF-I-DONEMSG, system authorization file modified 
SUAF-I-NAFNOMODS, no modifications made to network proxy database 
%SUAF-I-RDBDONEMSG, rights database modified 
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Privileges 
Two sets of privileges are specified in each UAF record: 
¢ Authorized 
— Privileges enabled only by explicit use of the DCL command 
SET PROCESS/PRIVILEGE 
* Default 


— Privileges automatically enabled once the user has logged in 


Table 8-14 lists the qualifiers used to set an account's privileges. 


Table 8-14 AUTHORIZE Qualifiers for Privilege Fields 
Qualifier ' Function 


/DEFPRIVILEGES=( [NO] privname[,...]) Specifies the list of privileges that are enabled 
at login time. The keyword [NOJALL disables or 
enables ail user privileges. 


/PRIVILEGES=([NO]privname[,...] ) Specifies the list of privileges granted (but not 
enabled) at login time. 


' Any privilege keyword used with either qualifier may be prefixed with NO to turn off the privilege. 


A complete listing of VMS privileges is presented in Table 8-15. 
Detailed definitions of these privileges may be found in the Guide to Setting Up a VMS System. 
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Privileges are divided into seven categories according to the damage that the user possessing 
them could cause the system: 


- None - No privileges 


¢ Normal - Minimum privileges to effectively use the system 


¢ Group - Potential to interfere with members of the same group 


¢ Devour - Potential to consume noncritical system-wide resources 


« System - Potential to interfere with system operation 


* File - Potential to compromise file security 


¢ All - Potential to control the system 


Table 8-15 VMS Privileges 


Category 
None 
Normal 


Group 


Devour 


Privilege 
None 
MOUNT 
NETMBX 
TMPMBX 
GROUP 
GRPPRV 
ACNT 
ALLSPOOL 
BUGCHK 
EXQUOTA 
GRPNAM 
PRMCEB 
PRMGBL 
PRMMBX 
SHMEM 


Allows User to: 

None requiring privileges 

Execute mount ACP function 

Create network device 

Create temporary mailbox 

Affect other processes in same group 
Have group access by system protection 
Suppress accounting message 

Allocate spooled device 

Make bugcheck log entries 

Exceed quota 

insert in group logical name table 
Create permanent common event clusters 
Create permanent global sections 
Create permanent mailbox 

Create/delete objects in shared memory 
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Table 8-15 VMS Privileges (Cont) 


Category 
System 


Files 


All 


Privilege 
ALTPRI 
OPER 
PSWAPM 
SECURITY 
SYSLCK 
WORLD 
DIAGNOSE 
SYSGBL 
VOLPRO 
BYPASS 
CMEXEC 
CMKRNL 
DETACH 
LOG_IO 
PFNMAP 
PHY_IO 
READALL 
SETPRV 
SHARE 
SYSNAM 
SYSPRV 
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Allows User to: 


Set any priority value 

Have operator privilege 

Change process swap mode 
Perform security functions 

Lock system-wide resources 

Affect other processes in the world 
Diagnose devices 

Create system-wide global sections 
Override volume protection 

Bypass UIC checking 

Change mode to executive 
Change mode to kernel 

Create detached processes 

Do logical I/O 

Map to specific physical pages 

Do physical I/O 

Read anything as the owner 

Set any privilege bit 

Assign channels to nonshared device 
Insert in system logical name table 
Access objects by system protection 


CONVERSATIONAL STARTUP 


The VMS system includes the option of examining and modifying the system parameters during 
startup, before the processor uses them to customize the system. This option is called a 
conversational startup. 


During a conversational boot a system manager can: 

¢ Specify a minimum startup 

¢ Select alternate file as the source of system parameter values 
« Set and show individual parameter values 

* Specify an alternate site-independent startup procedure 


« Turn on verification during startup command procedure execution 


For a system-specific detailed description, refer to the Hardware Operation Guide for VMS 
Systems. 


Table 8-16 Using SYSBOOT During Conversational Startup 
Function Command Format and Examples 


Examines a system parameter or group Of §sysSBOoT> SHOW parameter 

parameters SYSBOOT> SHOW /parameter-group 
SYSBOOT> SHOW MAXPROCESSCNT 
SYSBOOT> SHOW /ALL 


Modifies a system parameter SYSBOOT> SET parameter value 
SYSBOOT> SET MAXPROCESSCNT 60 
Modifies a group of system parameters SYSBOOT> USE parameter-file.PAR 


(.PAR files should be in SYS$SYSTEM) SYSBOOT> USE CURRENT 
SYSBOOT> USE DEFAULT 
SYSBOOT> USE ALTPARAM. PAR 


Uses an alternate DCL startup file SYSBOOT> SET/STARTUP SYSSSYSTEM: startup-file 
SYSBOOT> SET/STARTUP SYS$SYSTEM: ALTSTART 

Exits SYSBOOT to continue the startup SYSBOOT> CONTINUE 

procedure 
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Figure 8-1 Effect of VMS Startup on System Parameters 
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Bypassing the User Authorization File 


When you have a locked system, such as when all passwords have been forgotten, one method 
of breaking into the system is to set the alternate user authorization file. 


This method requires setting the system parameter UAFALTERNATE, which defines the logical 
name SYSUAF to refer to the file SYS$SYSTEM:SYSUAFALT.DAT. 


Use the following procedure to set the alternate user authorization file: 


Vs 


Using the instructions that can be found in the VMS Installation and Operations supplement 
for your computer, perform a conversational boot. (Follow the instructions only to where 
you receive the SYSBOOT> prompt.) 


At the SYSBOOT> prompt, enter the following command: 


SYSBOOT> SET UAFALTERNATE 1 


NOTE 


If your system is running DECwindows software, you must disable the 
windowing system by entering the following command: 


SYSBOOT> SET WINDOW _SYSTEM 0 
Type CONTINUE and press Return. 


After the startup procedure completes, you will be prompted for USERNAME: and 
PASSWORD:. You should then log in on the console terminal by entering any user name 
and password. 


Fix the problem that caused you to be locked out of the system. If it was a forgotten 
password, you should make the necessary changes to the UAF. 

$ DEFINE /SYSTEM/EXECUTIVE MODE SYSUAF SYSSSYSTEM:SYSUAF.DAT 

$ SET DEFAULT SYSSSYSTEM 


S$ RUN AUTHORIZE 
At the UAF> prompt modify the necessary passwords. 


Restore the UAFALTERNATE parameter using SYSGEN. If necessary, restore the 
WINDOW_SYSTEM parameter back to its original value. 

S$ RUN SYSSSYSTEM: SYSGEN 

SYSGEN> SET UAFALTERNATE 0 

SYSGEN> SET WINDOW SYSTEM 1 (If necessary) 

SYSGEN> WRITE CURRENT 

SYSGEN> EXIT 


The final step is to shut down the system and then reboot. 
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SUMMARY 


¢ The system must be made secure in two ways, both physically and its software. 
« One of the most important ways of securing the software is through strict login security: 
— Using system passwords 
— Screening a user-selected password for acceptability 
— Protecting terminals and other nonshareable devices 
— Monitoring against password collection programs and other break-in attempts 


« System managers must set up user accounts to provide the security needed for the 
environment they are working in. The VMS operating system provides a UIC-based 
protection but also an additional layer of ACL protection if you choose to enable it. 


¢ System managers can tailor user accounts to specify when and where a user can log in. 
They may also grant users a full range of privileges to allow precise access and control of 
various resources and operating system facilities. 


¢ VMS provides the SYSBOOT conversational startup utility as one method to modify system 
parameters. 
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Managing a Network Node 


INTRODUCTION 


Once the DECnet software has been configured, the network runs automatically and requires 
no intervention. 


The few cases in which the system manager needs to perform day-to-day management of a 
DECnet node include: 


« Adding node entries to the remote node database as new nodes are added to the network 


« Removing entries as nodes are removed from the network 


This chapter introduces the DECnet permanent and volatile databases and the utility that 
manages them, the network control program (NCP). It presents specific NCP operations that 
are used to: 

* Create, display, and modify node database parameters 

¢ Obtain node information from a remote node 


¢ Obtain a complete node database from another node in the network 


OBJECTIVES 


To monitor and control the network, a system and network manager should be able to: 
¢ Maintain the local node database 


¢ Obtain node information from other nodes 


RESOURCES 


* Guide to DECnet-VAX Networking 
¢ VMS Networking Manual 
¢« VMS Network Control Program Manual 


TOPICS 


* Review: starting, stopping, and monitoring the network 
* NCP overview 
¢ Maintaining the remote node database 


¢« Executing remote commands 
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REVIEW: STARTING, STOPPING, AND MONITORING 
THE NETWORK 


Starting the Network 


This command starts DECnet software and should be included in the SYSTARTUP_V5.COM 
procedure: 


$ @SYSSMANAGER: STARTNET.COM 


Stopping the Network 


The following commands shut down the network, allowing existing network operations to 


complete but preventing new operations from being started: 


$ RUN SYSSSYSTEM: NCP eh WA 
N SYSSS M: wh? we 


ov % 
NCP> SET EXECUTOR STATE OFF as we ~ ae CBN _ 
—— AX joe a va \ 


NCP> NG a 
The SHOW NETWORK Command 


The SHOW NETWORK command tells you whether the DECnet software is running. 


On a nonrouting node: 


$ SHOW NETWORK 
VAX/VMS Network status for local node 62.820 TOYDOC on 11-SEP-1991 16:03:09.56 


This is a nonrouting node, and does not have any network information. 
The designated router for TOYDOC is node 62.1022 ZKDRC. 

On a routing node: 

$ SHOW NETWORK 


VAX/VMS Network Status for local node 2.161 ARAKIS on 
19-APR-1990 09:18:03.07 
The next hop to the nearest area router is node 2.62 ZEUS. 


Node Links Cost Hops Next Hop to Node 
2.161 ARAKIS 0 0 0 Local -> 2.161 ARAKIS 
2, RAEL 0 8 1 UNA-O -> 2d RAEL 
2.63 AURORA 0 8 i UNA-0 -> 2.63 AURORA 


Total of 7 nodes. 


If the DECnet software is not running: 


$ SHOW NETWORK 
SSHOW-I-NONET, network unavailable 
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DECnet CONFIGURATION DATABASES 


A DECnet configuration database contains data about the network, including: 
¢« Nodes — other systems connected to the network 

* Objects — network applications on the local node 

* Circuits — communication paths between nodes 


¢ Lines — physical data paths between nodes 


The DECnet configuration database consists of two distinct databases, one permanent and one 
volatile. 


Permanent Database 


The permanent database is a collection of files in SYS$SYSTEM that contain the permanent 
settings for the network parameters. Features of the permanent database: 


« Resides on disk 
¢ Provides initial values for the volatile database 


*« Changes take effect the next time DECnet software is started up 


Volatile Database 


The volatile database is a memory-resident image containing current information about network 
management components. Features of the volatile database are: 


« Allows changes to be made to a running system 
*« Changes take effect immediately 


- Values are lost when system-is-Shut-dOwR 


— 
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Maintaining the DECnet Configuration Database 
¢ Most of the information in the DECnet configuration database is set automatically when the 
node is installed in the network. 
* You may need to maintain some of the information manually: 
— Change the name and address of the local node. 
The executor (local) database is SYS$6SYSTEM:NETNODE_LOCAL.DAT. 
— Update the list of names and addresses of the remote nodes in the network. 
The remote node database is SYS$SYSTEM:NETNODE_REMOTE.DAT. 


You do not edit the databases directly; instead you use the network control program (NCP). 


identifying a Node 

Each node in the network is identified by two values: 

* The node name, which consists of up to six alphanumeric characters 

¢« The node address, in the form aa.nnnn, where: 
—  aais the area number (from 1 to 63, or 0 if the network is not divided into areas) 
—  nnnn is the node number within the area (from 1 to 1024) 

¢ Every node in the network must have a unique name and address. 


— Someone must act as a network administrator, assigning names and addresses to 
guarantee that they are unique. 
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NCP OVERVIEW 


As nodes are added to and removed from the network, use the network control program (NCP) 
to maintain the remote node database on your system. 


Invoking and Exiting NCP 


To invoke NCP: 


$ RUN SYS$SYSTEM:NCP 
NCP> 


Table 9-1 shows the commands that you use to maintain the configuration databases. 


Table 9-1 Commands that Maintain the Configuration Databases 
Command for Volatile Command for Permanent 


Function Database Database 
Create/modify parameters SET DEFINE 
Delete parameters CLEAR PURGE 
Display parameters SHOW | LIST 
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DECnet Privileges 


You must be logged in to a privileged account to access the permanent database or modify the 
volatile database. Table 9-2 lists the privileges required for various NCP commands. 


Table 9-2 Required DECnet Privileges 


Commands) Privilege(s) 
SHOW None 


SET, CLEAR OPER 


LIST SYSPRV 
DEFINE, OPER, 
PURGE SYSPRV 
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Reason 


SHOW does not affect either database, nor does it access the 
permanent database. 


These commands affect the volatile database only, but must 
still be used with caution. 


The LIST command displays information from the permanent 
database. Only users with system privilege may access 

the permanent database. To display password information, 
BYPASS is needed as well. 


These commands manipulate the permanent database. 
OPER is needed to manipulate any database; SYSPRV is 
needed to access the permanent database. 


MAINTAINING THE REMOTE NODE DATABASE 


Adding Remote Nodes to Your Configuration Database 
Example 9-1 shows how to add a remote node to the configuration database. 
Example 9—1 Adding a Remote Node 

NCP>SHOW KNOWN NODES @ 


Known Node Volatile Summary as of 9-SEP-1988 11:23:44 
Executor node = 26.60 (LUIGI) 


State = on 
Identification = DECnet-VAX V5.0, VMS V5.0 
Node State Active Delay Circuit Next node 
Links 

4.20 (FIGMEN) QNA-0 26.15 (CYCLPS) 
24.29 (ANCHOR) QNA~0O 26.15 (CYCLPS) 
26.15 (CYCLPS) QNA-0 26.15 (CYCLPS) 
26.24 (DEMON) QNA-0O 26.15 (CYCLPS) 
26.25 (SPRITE) QNA-0O 26.15 (CYCLPS) 
26.49 (PILGRM) QNA-O 26.15 (CYCLPS) 
26.61 (ENT) 1 1 QNA-0O 26.15 (CYCLPS) 
26.130 (SWSVAX) QNA-0O 26.15 (CYCLPS) 
26.143 (PARROT) QNA-0 26.15 (CYCLPS) 
26.148 (TBD3) QNA-0 26.15 (CYCLPS) 


NCP>DEFINE NODE 3.4 NAME Toys @ 

NCP>SET NODE 3.4 ALL © 

NCP>SHOW KNOWN NODES 

Known Node Volatile Summary as of 9-SEP-1988 11:24:09 
Executor node = 26.60 (LUIGI) 


State = on 
Identification = DECnet V5.0, VMS V5.0 
Node State Active Delay Circuit Next node 
Links 

3.4 (TOYS) QNA-0 26.15 (CYCLPS) @ 
4.20 (FIGMEN) QNA-0O 26.15 (CYCLPS) 
24.29 (ANCHOR) QNA-0O 26.15 (CYCLPS) 
26.15 (CYCLPS) QNA-0 26.15 (CYCLPS) 
26.24 (DEMON) QNA-0O 26.15 (CYCLPS)} 
26.25 (SPRITE) QNA-0 26.15 (CYCLPS) 
26.49 (PILGRM) QNA-O 26.15 (CYCLPS) 
26.61 (ENT) 1 1 QNA-O 26.15 (CYCLPS) 
26.130 (SWSVAX) QNA-0 26.15 (CYCLPS) 
26.143 (PARROT) QNA-0 26.15 (CYCLPS) 
26.148 (TBD3) QNA-0O 26.15 (CYCLPS) 
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Notes on Example 9—1: 


The SHOW KNOWN NODES command confirms that neither the name TOYS 1 nor the 
address 3.4 is already in use (in the volatile database). 


The DEFINE NODE command adds the node to the permanent database. 
The command DEFINE NODE TOYS ADDRESS 3.4 would be equivalent. 


The SET NODE ... ALL command copies the value in the permanent database into the 
volatile database. 


The second SHOW KNOWN NODES command confirms that the node was added with the 
correct name and address. 


Note that DECnet software automatically determines which circuit is used for communication 
with the remote node, and which node is the next one in the path to that remote node. 
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Copying Known Nodes 


As new nodes are added to the network, it is each network/system manager’s responsibility to 
maintain the list of remote nodes in the database. The system manager on the local node can: 


* Manually enter a separate command for each node that needs to be defined 


¢ Use the COPY KNOWN NODES command 


The COPY KNOWN NODES command copies the names and addresses of remote nodes 
from a remote database to your local node’s database. Follow these steps to use the COPY 
KNOWN NODES command: 
1. Add anode to your database that has a complete list of node definitions. 

NCP>SET NODE 2.4 NAME COOKIE 
2. Then, to copy the remote node information from node COOKIE to both the permanent and 

volatile databases: 
NCP>COPY KNOWN NODES FROM COOKIE TO BOTH 


3. Use the SHOW KNOWN NODES or LIST KNOWN NODES command to ensure that the 
remote nodes are defined on your system. 
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Removing a Node from the Database 


Sometimes it is necessary to remove information about a remote node from your remote node 
database. Use the CLEAR and PURGE commands to accomplish this. 


Example 9-2 demonstrates how to remove a node from the volatile database. 


Example 9-2 Removing a Node from the Database 


NCP>SHOW NODE zopiac @ 


Node Volatile Summary as of 26-SEP-1988 16:28:10 


Node State Active Delay Circuit Next node 
Links 
26.190 (ZODIAC) QNA-0O 26.133 
NCP> 
NCP>CLEAR NODE ZODIAC ALL @ 
NCP> 


NCP>SHOW NODE zopIac @ 


Node Volatile Summary as of 26-SEP-1988 16:28:30 
SNCP-W-UNRCMP, Unrecognized component , Node 


Notes on Example 9-2:/bold 
@ First, make sure the node is in the database using a SHOW NODE command. 


@ The CLEAR NODE command removes the node entry from the volatile database. If the 
node is also in the permanent database, you must use a PURGE NODE command to 
remove it. 


© A second SHOW NODE command confirms that the node is no longer in the volatile 
database. 
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Changing Remote Node Entries 


You can change a remote node’s node name or node address by first deleting the remote node 
from your node’s database and then redefining the remote node. 


lf node WENDI moves to a different location on the network, you can change its address in 
your database by issuing the commands shown in Example 9-3. 


Example 9-3 Changing a Remote Node Entry 


NCP>SHOW NODE WENDI @ 


Node Volatile Summary as of 27-SEP-1988 10:18:00 


Node State Active Delay Circuit 
Links 


26.89 (WENDI) QNA-0 
NCP> 

NCP>CLEAR NODE WENDI ALL @ 

NCP>SET NODE 4.118 NAME WENDI © 

NCP>SHOW NODE WENDI 


Node Volatile Summary as of 27-SEP-1988 10:19:02 


Node State Active Delay Circuit 
Links 


4.118 (WENDI) QNA-0O 
NCP> 


Notes on Example 9-3: 


2) 
3 
14) 


First find out if the node address is current. 


Next node 


26.133 


Next node 


26.133 © 


If the node address is not current, remove the node from the database. 


Then, add the node with the correct address. 


Another SHOW command confirms that the node is now defined correctly. 
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EXECUTING REMOTE COMMANDS 


Most NCP commands issued on the local node are executed on that node. Occasionally, you 
may want to issue commands from the local node to be executed on remote nodes. 


¢ The executor node is the node on which NCP functions are actually performed. 

¢ To perform network management functions on remote nodes, NCP supports two commands: 
— TELL 
— SET EXECUTOR NODE 


TELL Command 
Use the TELL command to: 
* Execute a single command at a remote node 


¢ Temporarily override the current executor 


Example 9-4 shows the use of the TELL command. 
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Example 9-4 Using the TELL Command 


NCP>CLEAR EXECUTOR NODE @ 

NCP>SHOW EXECUTOR @ 

Node Volatile Summary as of 29-SEP-1988 18:53:01 
Executor node = 26.60 (LUIGI) 


State 
Identification 


on 
DECnet-VAX V5.0, VMS V5.0 


NCP>TELL PARROT SHOW EXECUTOR © 


Node Volatile Summary as of 29-SEP-1988 18:53:18 
Executor node = 26.143 (PARROT) 


State 
Identification 
Active links 


on 
DECnet-VAX V5.4, VMS V5.4 
4 


NCP>TELL PARROT SHOW NODE LDYBUG @ 
Node Volatile Summary as of 29-SEP-1988 19:44:40 


Node State Active Delay Circuit Next node 
Links 


5.571 (LDYBUG) DMP-O 26.221 (APO26B) 


Notes on Example 9-4: 


The CLEAR EXECUTOR NODE command ensures that the executor node is the local 
node, LUIGI (in case you previously entered a SET EXECUTOR commana). 


The SHOW EXECUTOR command shows which node is currently the executor. 


The TELL command tells NCP to use the remote node’s network management software 
and databases to execute the SHOW EXECUTOR CHARACTERISTICS command. The 
output indicates that the node executing the command was PARROT. 


A good use of the TELL command is to find out the address or name of a node that is not 
in the database on the local system, but is in the database on another system. 
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Setting an Executor Node 


An alternative to using multiple TELL commands is the SET EXECUTOR NODE command. It 
allows you to choose the node at which you want NCP commands to execute, as shown in 
Example 9-5. 


Example 9-5 Setting an Executor Node 


NCP>SHOW EXECUTOR @ 
Node Volatile Summary as of 9-SEP-1988 14:57:39 
Executor node = 26.60 (LUIGI) 


State 
Identification 


on 
DECnet-VAX V5.0, VMS 


NCP>SET EXECUTOR NODE BOSTON @ 
NCP>SHOW EXECUTOR 


Node Volatile Summary as of 9-SEP-1988 14:57:55 
Executor node = 2.7 (BOSTON) 


State 
Identification 


on 
DECnet-VAX V5.0, VMS 


NCP>CLEAR EXECUTOR NODE @ 
NCP>SHOW EXECUTOR 


Node Volatile Summary as of 9-SEP-1988 14:58:34 
Executor node = 26.60 (LUIGI) 


State 
Identification 


on 
DECnet-VAX V5.0, VMS 


iol 


Notes on Example 9-5: 


o 
2] 


V5.0 


V5.0 


V5.0 


Before the executor node is manipulated, the local node (LUIGI) is the executor node. 


The SET EXECUTOR NODE command temporarily changes the executor node to 
BOSTON. All subsequent commands will be executed on BOSTON until the executor node 


is changed again. | 


The SHOW EXECUTOR command displays information about the current executor node. 


The CLEAR EXECUTOR NODE command resets the executor node back to the local node 
(LUIGI). The subsequent SHOW EXECUTOR NODE confirms this. 


” 
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Indicating Access Control for Remote Command Execution 


With the SET EXECUTOR NODE command, you can specify access control information as 
shown in Example 9-6. 


Use this feature if a TELL or SET EXECUTOR command results in a “login information invalid 
at remote node" message. 


Example 9-6 Using Access Control for Remote Command Execution 


NCP>SET EXECUTOR NODE LUIGI"SYSTEM CHOCOLATE" 
NCP>LIST EXECUTOR CHAR 


Node Permanent Characteristics as of 29-SEP-1988 18:34:42 
Executor node = 26.60 (LUIGT) 


Management version = V4.0.0 

Type = nonrouting IV 
Maximum address = 1023 
Nonprivileged user id = DECNET 
Nonprivileged password = DECNET 
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SUMMARY 


Every DECnet node has a configuration database that defines the characteristics of that node 
and determines how it functions within the network. In VMS implementations, this configuration 
database is provided within the DECnet software supplied by Digital. | 


To provide network management flexibility, each node’s database consists of two distinct 
databases: 


¢ Permanent (fixed) database 


¢ Volatile (temporary) database 


The network control program (NCP) is a network management tool to create, display, and 
modify component parameters in the DECnet configuration databases. NCP is used to: 


« Monitor and test the network 


¢ Create, display, and modify permanent and volatile database parameters for DECnet 
software 


Node, line, and circuit commands help network managers to configure a node properly in the 

DECnet network. The SET/DEFINE NODE command is used to add a remote node to your 

system's configuration database. The COPY KNOWN NODES command eliminates the need 

to manually add entries for remote nodes to the database. This command copies the remote 
node entries from another node’s configuration database. 


For added flexibility in network management, NCP incorporates the concept of an executor 
node. The executor node is the node on which NCP functions are actually performed. To 
perform network management functions on remote nodes, NCP supports two commands: 

° TELL 


¢ SET EXECUTOR NODE 
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System Monitoring 


INTRODUCTION 


Monitoring the system is one of the primary responsibilities of the system manager. It allows the 
system manager to ascertain the performance of the system, while providing a characteristic 
view of the normal activity. This is an asset when problems arise. The MONITOR utility and 
particular DCL SHOW commands are discussed to help system managers interpret or analyze 
the various status/performance reports and graphs. Discussion also includes how to monitor a 
network and VAXcluster system, since most VAX systems today form that popular configuration. 


Memory is often the key to improving system performance, provided it is utilized correctly. 
Monitoring memory resource usage will be helpful in determining system performance, which 
will be introduced later in the VMS System and Network Management III course. While it is 
often hard to divorce the two subjects, monitoring the system, and the tools or commands used 
to monitor it, is the focus of this chapter, not system performance. 
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OBJECTIVES 


System managers should periodically monitor system activity in order to establish a baseline of 
system performance. To do this effectively, they should be able to: 


Monitor process memory usage 

Monitor process paging demands on the system 

Utilize the MONITOR utility for obtaining this specific process information 

Utilize appropriate DCL commands to help with analysis of memory resource usage 
Monitor a network and utilize specific network control program (NCP) commands 


Monitor the VAXcluster system by using various SHOW CLUSTER and MONITOR utility 
commands 


RESOURCES 


Introduction to VMS System Management 
VMS System Manager's Manual 

VMS Monitor Utility Manual 

VMS Network Control Program Manual 
Guide to DECnet-VAX Networking 

VMS Networking Manual 

VMS Show Cluster Utility Manual 


TOPICS 


MONITOR Utility 
Monitoring with DCL commands 
Using the network control program (NCP) 


Using SHOW CLUSTER in a VAXcluster system 
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MONITOR UTILITY 


To display information about system resource usage: 
$ MONITOR class-name(s) [/qualifiers] 


Example 10-1 Invoking the MONITOR Utility 


$ MONITOR 
MONI TOR> 


MONITOR commands can: 

¢ Display a class of information 
¢ Set default classes 

¢ List defaults 

* Execute command procedures 
¢ Obtain help 


¢ Exit from the utility 


Unlike most utilities that display system information, MONITOR can: 


¢ Display several classes of information alternately 
¢« Summarize statistics over a long period of time 
¢ Record information in a disk file 


¢ Play back information that it has recorded 
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Example 10—2 displays the MONITOR SYSTEM screen. 


Example 10-2 MONITOR SYSTEM Screen Display 


Node: OTHER 
Statistic: CURRENT 


+ CPU Busy (96) =a 
| KA KKAKKKARKKKKKKKKK KKK KKK | 


CPU Q +-------------------------- + 


Cur Top: BATCH 1036 (56) 


+ Page Fault Rate (108) -—+ 
| [| RAR AAKKARKKKARKKAEKKKAKKKK KE | 


MEMORY 0 +-------------------------- + 


Cur Top: MARCH (106) 


+ Direct I/O Rate (52) =e 
[AA KKAKKAKKKKKKKKKKKREKKK | 
1/0 Q +-------------------------- + 
[ RR AKKKKKKKKKKKKKKK KK | 
$-------------------------- + 


Cur Top: BATCH 1036 (47) 


VAX/VMS Monitor Utility 


100 


100 


27-AUG-1991 17:18:41 


SYSTEM STATISTICS 


Process States 


LEF : 5 LEFO: 0 
HIB: 19 HIBO: 0 
COM: 2 COMO: 0 
PFW: 0 Other: 1 
MWAIT: 0 

Total: 27 


+ Free List Size (76414) -+ 


[ AA AKKKKKEKKKAEKKKEKKKAKK | 89K 
fona-- + - -- = + 
| A kkk ak ak | 2621 
+ Modified List Size (917) + 
+ Buffered I/O Rate (4) —+ 
| | 
a a en + 150 
| | 
$o----------- ~~ - - +--+ + 


Cur Top: MARCH (4) 


¢ The display is updated regularly (every three seconds by default) 


¢ Each value is averaged over the sampling interval (three seconds by default) that yields a 


rate on a per second basis 


- For certain displays (SYSTEM, CLUSTER, ALL_CLASSES) the default is six seconds 
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~ Table 10-1 lists the MONITOR PROCESSES class qualifiers. 


Table 10-1 MONITOR PROCESSES Class Qualifiers 


Description Qualifier 
Top buffered I/O users /TOPBIO 
Top direct !/O users _  /TOPDIO 
Top CPU users /TOPCPU 
Top page fault users /TOPFAULT 


Example 10-3 illustrates the MONITOR PROCESSES /TOPCPU screen display. 
Example 10-3 MONITOR PROCESSES /TOPCPU Screen Display 


$ MONITOR PROCESSES /TOPCPU 


VAX/VMS Monitor Utility 
TOP CPU TIME PROCESSES 
on node OTHER 
27-AUG-1991 17:13:54 


0 25 50 75 100 
t+ ---- +t --- ete - He Ht HH eH He + 
21200524 BATCH 1036 TR RR KKK KKK KR K KKK KKK KKK RK KK KK RK KKK 
| | | | 
21200646 J _WARTEN Q *kk 
| | | | | 
2120083F WATTEWS 1 3 * 
| | | | 
| | | | | 
| | | | 
| | | | | 
| | | | 
ee + 


« The display is updated regularly (every three seconds by default). 
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Example 10-4 shows the MONITOR screen display of the PAGE class. 
Example 10—4 MONITOR Screen Display of the PAGE Class 


$ MONITOR PAGE 


VAX/VMS Monitor Utility 
PAGE MANAGEMENT STATISTICS 
on node SPIDER 
28-AUG-1991 17:04:35 


CUR AVE MIN MAX 

Page Fault Rate 17.41 67.08 0.00 2469.35 
Page Read Rate ae r) 0.32 15.54 0.00 622.68 
Page Read I/O Rate Loh rol 0.32 1.05 0.00 12.14 
Page Write Rate 0.00 0.77 0.00 77.17 
Page Write I/O Rate 0.00 0.00 0.00 0.64 
Free List Fault Rate 7.74 9.19 0.00 212.50 
Modified List Fault Rate 1529 12.48 0.00 1031.93 
Demand Zero Fault Rate 7.09 34.57 0.00 1269.35 
Global Valid Fault Rate 0.96 9.69 0.00 131263 
Wrt In Progress Fault Rate 0.00 0.00 0.00 0.00 
System Fault Rate 0.00 0.00 0.00 0.00 
Free List Size 61723.00 66910.74 61723.00 68791.00 
. Modified List Size 4909.00 4189.02 3855.00 5075.00 


* Each value is updated regularly (every three seconds by default). 


¢ The current value (CUR) is averaged over the sampling interval (three seconds by default), 
yielding a rate on a per-second basis. 


* Other values are cumulative since the time you entered the MONITOR command. 
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Using MONITOR in a Network 


Example 10-5 MONITOR DECnet 


$ MONITOR DECNET 


VMS Monitor Utility 
DECNET STATISTICS 


on node LUIGI From: 26-SEP-1988 10:44:03 

SUMMARY To: 26-SEP-1988 10:44:33 
CUR AVE MIN MAX 
Arriving Local Packet Rate 0.00 0.33 0.00 0.66 
Departing Local Packet Rate 0.99 0.43 0.00 0.99 
Arriving Trans Packet Rate 0.00 0.00 0.00 0.00 
Trans Congestion Loss Rate 0.00 0.00 0.00 0.00 
Receiver Buff Failure Rate 0.00 0.00 0.00 0.00 
LRPs Available 28.00 28.00 24.00 30.00 
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Using MONITOR in a VAXcluster System 
MONITOR classes that are cluster-specific: 

¢ CLUSTER gives statistics over the entire cluster 
MONITOR qualifiers that are useful in a cluster: 

« /NODE gives statistics from particular nodes 


¢« /BY_NODE gives a multinode summary 


MONITOR CLUSTER Command 


Example 10-6 MONITOR CLUSTER Output 


$ MONITOR 
MONITOR> MONITOR CLUSTER 
SMONITOR-I-ESTABCON, establishing connection to remote nodes... 


Statistic: CURRENT VAX/VMS Monitor Utility 27-AUG-1991 16:55:47 
CLUSTER STATISTICS 
CPU | MEMORY 
| 
CPU Busy 0 25 50 #75 100|%Memory In Use 0 25 50 #75 100 
$n tet $F | tenn fern tan nr en tet 
HORSE 100 | KR KKKKKKKKKKKKKKKKKK | HORSE 94 | RXKKAKKKKKKKKKKKKKK 
TIGER 19 | *x** [TIGER QQ | RR RRR KR RRR RK KK 
BARNUM 11 | ** | LION 64 [RRR RRR RRR KR 
BAILEY 5 | | BAILEY 43 | KaK RK KKK 
RNGLNG 4 | | RNGLNG 32 | x#eKKK 
LION 4 | | BARNUM 24 | xek 
BEAR 4 | | BEAR 22 [kek 
ee ne ee ee ee me ee ee ee mm a a ee a a a a ee ee ee ee 
DISK | LOCK 


I/O Operation Rate 0 25 50 75 100|Tot ENQ/DEQ Rate 0 125 250 375 500 


fone f+ -- +--+ | a an an ers 

SISDUAO: 6 |* | BARNUM 8 | 
S1SDUAO: R 6 |* | RNGLNG | 
$1SDUA1: 2 | | TIGER | 
S1SDUA1: R 1 | | HORSE | 
S1SDUA2: | | LION | 
$1SDUA3: | | BAILEY | 

| BEAR | 
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MONITOR/NODE Qualifier 


Example 10-7 Using the /NODE Qualifier with MONITOR DISK 


MONITOR> MONITOR/NODE= (BARNUM, BAILEY,RNGLNG) DISK 
SMONITOR-I-ESTABCON, establishing connection to remote nodes... 


VAX/VMS Monitor Utility 
DISK I/O STATISTICS on node BARNUM 
19-JUN-1991 11:25:11 


I/O Operation Rate CUR AVE MIN MAX 
S1SDUAO: (CLOWN) BARNUM SYS 0.59 6.90 0.00 16.75 
S1SDUAI1: (CLOWN) TIGHTROPE 0.00 0.15 0.00 0.94 
S1SDUA2: (BARNUM) FLYING 0.00 0.00 0.00 0.00 
S1SDUA3: (BAILEY) TRAPEZE 2.09 3.31 0.00 11.59 
S2SDUAO0: (HORSE) THREE 0.00 0.03 0.00 1.21 
S2SDUAI1: (HORSE) RING 0.00 0.00 0.00 0.00 


VAX/VMS Monitor Utility 
DISK I/O STATISTICS on node BAILEY 
19-JUN-1991 11:25:18 


I/O Operation Rate CUR AVE MIN MAX 
$1SDUAO: (CLOWN) BARNUM_ SYS 0.00 0.16 0.00 1.89 
$1SDUA1: (CLOWN) TIGHTROPE 0.00 0.05 0.00 0.63 
S1SDUA2: (BARNUM) FLYING 0.00 0.00 0.00 0.00 
SISDUA3: (BAILEY) TRAPEZE 0.00 0.00 0.00 0.00 
S2SDUAO0: (HORSE) THREE 0.00 0.00 0.00 0.00 
S$2SDUA1: (HORSE) RING 0.00 0.00 0.00 0.00 


VAX/VMS Monitor Utility 
DISK I/O STATISTICS on node RNGLNG 
20-DEC-1989 11:25:16 


I/O Operation Rate CUR “AVE MIN MAX 
S$1SDUAO: (CLOWN) BARNUM SYS 2.18 1.82 0.00 9.09 
$1SDUA1: (CLOWN) TIGHTROPE 05.34. 0.02 0.00 0.31 
S1$DUA2: (BARNUM) FLYING 0.00 0.63 0.00 7.83 
S1SDUA3: (BAILEY) TRAPEZE 5.00 1.39 0.00 7.82 
S2SDUA0: (HORSE) THREE 0.00 0.00 0.00 0.00 
S2SDUAI1: (HORSE) RING 0.00 0.00 0.00 0.00 


An example, Command Procedure for Monitoring the VAXcluster System, exists in the Appendix. 
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MONITOR Multinode Summary 
MONITOR gathers data on only one node. 


¢- You can generate a multinode summary for any MONITOR class. This is especially useful 
for monitoring total disk activity. 


For a side-by-side display of MONITOR data from multiple nodes: 
¢ Use MONITOR to collect data in a file on each node. 


« Then use MONITOR/SUMMARY/BY_NODE to combine the data files and produce a 
multinode summary. 


For example, if BAILEY_MON and BARNUM_MON are the recording files for two nodes: 


$ MONITOR /NODISPLAY /INPUT=(BAILEY MON, BARNUM_MON) - 
$  /SUMMARY /BY_NODE DISK 
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Command Procedures 


$ DIRECTORY SYSSEXAMPLES: *MON* 

Directory SYSSCOMMON: [SYSHLP.EXAMPLES] 

MONITOR. COM; 1 MONSUM. COM; 1 SUBMON.COM;1 
Total of 3 files. 


« SUBMON.COM 

— Executes the data collection command procedure (MONITOR.COM) 

— Invoked automatically at system startup time when added to SYSTARTU P_V5.COM 
¢ MONITOR.COM collects the data 

— Mails a summary report.for each reboot 

— Archives the data collection file 
¢ MONSUM.COM mails two different summary reports 

eas One for a 24 hour period 

— One for prime time usage 

— Command procedure resubmits itself (once invoked manually) 


* Logicals SYS$MONITOR and MON$ARCHIVE must be defined and these command 
procedures relocated appropriately 


¢ MONITOR.COM and MONSUM.COM must be edited to specify the user name to mail the 
reports to 


* MONSUM.COM prime time hours may need to be modified for the site 


* Edit SYSTARTUP_V5.COM to start up the monitoring command procedure, for example: 


S$ @SYSSMONITOR: SUBMON. COM) 


References 


For more information, please refer to the Appendix — Monitoring the System Command 
Procedures. ; 
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MONITOR Command Summary 


Table 10-2 lists the MONITOR class names and gives a brief description of each, along with 


some qualifiers. 


Table 10—2 MONITOR Class Names 
Class Description 


All classes 

Brief display of system status in a cluster 
DECnet software statistics 

Disk 1/O statistics 

Distributed lock management statistics 

File system statistics 

File system cache statistics 

System 1|/O statistics 

Lock management statistics 

Time spent in each processor mode 

Disk server statistics in cluster 

Page management statistics 

Space allocation in nonpaged dynamic memory 
Statistics on all processes 

RMS file I/O statistics 

System communication services statistics 
Number of processes in each scheduler state 


Brief display of general system status (includes 
information displayed in other classes) 


Command Qualifier Description 
Uses one or more binary input files 
Allows turning off screen display 


Specifies the nodes for which data is to be 
collected 


Generates binary data collection file 
Generates summary output file 
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Class Name 
ALL_CLASSES 
CLUSTER 
DECNET 

DISK 

DLOCK 

FCP 

FILE SYSTEM_CACHE 
lO 

LOCK 

MODES 

MSCP 

PAGE 

POOL 
PROCESSES 
RMS 

SCS 

STATES 
SYSTEM 


Command Qualifier Name 
/[INPUT 

/NODISPLAY 

/NODE 


/RECORD 
/SUMMARY 


MONITORING WITH DCL COMMANDS 


Memory Resources 

System performance is strongly dependent on the amount of physical memory. 

The SHOW MEMORY command displays information about the system’s physical memory. 
Example 10-8 shows a sample of the SHOW MEMORY command. 

Example 10-8 SHOW MEMORY Output 


$ SHOW MEMORY 
System Memory Resources on 27-AUG-1991 16:39:33.81 


Physical Memory Usage (pages): Total Free In Use Modified 
Main Memory (16.00Mb) @ 32768 @ 23954 8516 @ 298 
Slot Usage (slots): Total Free Resident Swapped 
Process Entry Slots 30 11 19 0 
Balance Set Slots 27 10 17 0 
Fixed-Size Pool Areas (packets): Total Free In Use Size 
Small Packet (SRP) List 640 102 538 96 
I/O Request Packet (IRP) List 328 96 232 176 
Large Packet (LRP) List 39 19 20 1648 
Dynamic Memory Usage (bytes): Total Free In Use Largest 
Nonpaged Dynamic Memory 643584 36512 607072 30272 
Paged Dynamic Memory 205312 75600 129712 74480 
Paging File Usage (pages): Free Reservable Total 
DISKSCOCOA_SYS: [SYSO.SYSEXE] SWAPFILE.SYS 
15000 15000 15000 
DISKSCOCOA_SYS: [SYSO.SYSEXE] PAGEFILE.SYS 
23636 -6941 30000 


Of the physical pages in use, 3976 pages are permanently allocated to VMS. 
@ 32768 pages equates to 16 MB of physical memory 
@ There are 23954 pages currently free for use 
© Of the 8814 pages in total use, 298 have been modified (written) 
@ Swapping file and paging file free as compared to the total is important 
* The negative reservable page count is normal 
¢ VMS algorithm reserves pages for all processes at worst case 
« The total pages minus the free pages is what is currently being used 
* RSRVPAGCNT system parameter controls this number 


¢ This number would become even more negative if another user logs in 
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Table 10-3 shows the effect of memory sizes on performance. 


Table 10-3 Effect of Memory Sizes on Performance 


Item 


Free physical memory 


Free process entry slots 
Free balance set slots 


Fixed-size pool areas 
(packets) 


Free paged dynamic 
memory, free nonpaged 
dynamic memory 


Free swapping file pages 


Free paging file pages 
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Description 


Size of the free page list 
(the number of pages 
available for processes that 
need memory) 


The number of additional 
processes the VMS system 
can create 


The maximum number of 
additional processes the 
VMS system can swap in 


Nonpaged memory in 
system space, used 
primarily for /O 


The amount of dynamic 


memory left for the system 
to use 


The number of pages 
available on disk for 
swapping 


The number of pages 
available on disk for paging 


Problem 


If less than a few hundred 
blocks, swapping occurs. 


If zero, no users can log in 
and no new processes can be 
created. 


lf zero, swapping occurs even 
if there are enough free pages 
available. 


lf any item is zero, the 
system tries to increase it. 
Enter the SHOW MEMORY 
/FULL command for more 
information. 


If too small, system response 
deteriorates. 


If too small, the VMS system 
uses paging file instead 
(can significantly reduce 
performance). 


lf too small, processes wait in 
MWAIT state. System prints 
a message on the console 
terminal when the paging file 
reaches 60 percent and 90 
percent full. 


SHOW SYSTEM Qualifiers 


SHOW SYSTEM has two qualifiers, /CLUSTER and /NODE, that are useful in a VAXcluster 


system. 


Example 10-9 SHOW SYSTEM/CLUSTER Command 


$ SHOW SYSTEM /CLUSTER 


VAX/VMS V5.3-2 on node BUZBI 27-AUG-1991 08:56:09.91 Uptime 0 23:54:25 
Pid Process Name State Pri I/O CPU Page flts Ph.Mem 
23E00041 SWAPPER HIB 16 0 0 00:00:06.53 0 0 
23E00047 ERRFMT HIB 7 TT3 0 00:00:06.39 81 132 
23E00048 CACHE SERVER HIB 16 74 0 00:00:00.29 66 112 
23500049 CLUSTER SERVER CUR 8 446 0 00:00:17.98 128 231 
23E0004A OPCOM HIB 8 278 0 00:00:13.79 219 162 
VAX/VMS V5.3-2 on node CANDY 27-AUG-1991 08:56:10.48 Uptime 0 23:46:04 
Pid Process Name State Pri E70 CPU Page flts Ph.Mem 
25800041 SWAPPER HIB 16 0 0 00:00:17.05 0 0 
25800047 ERRFMT HIB 8 q75 0 00:00:12.09 81 118 
25800048 CACHE SERVER HIB 16 84 0 00:00:00.61 62 94 
VAX/VMS V5.3-2 on node HARLEY 27-AUG-1991 08:56:11.12 Uptime 0 17:46:28 
Pid Process Name State Pri I/O CPU Page fits Ph.Mem 
26E00041 SWAPPER HIB 16 0 0 00:00:07.67 0 0 
26E00084 DECWSWM 1 LEF 7 5Z 0 00:00:07.84 1286 1683 
26E00047 ERRFMT HIB 8 559 0 00:00:03.51 81 124 
26E00048 CACHE SERVER HIB 16 12 0 00:00:00.07 62 100 
VAX/VMS V5.3-2 on node ZOOZOO 27-AUG-1991 08:56:15.56 Uptime 0 20:37:34 
Pid Process Name State Pri I/O CPU Page fits Ph.Mem 
26C00041 SWAPPER HIB 16 0 0 00:00:08.23 0 0 
26C00082 WSAI1: LEF 6 66 0 00:18:26.22 2681 512 
26C00047 ERRFMT HIB 8 661 0 00:00:04.12 81 132 
26C00048 CACHE SERVER HIB 16 25 0 00:00:00.14 62 108 
26C00049 CLUSTER_SERVER CUR 8 356 0 00:00:12.63 126 229 
26C00050 REMACP HIB 8 8 0 00:00:00.10 64 49 
26C00053 INSPECTSExec HIB 8 102 0 00:00:01.73 545 716 
26C00054 DTPQUEMAN LEF 5 36 0 00:00:00.59 257 332 
26C00058 DECWSSERVER_0O HIB 6 12593 0 00:08:57.27 9873 970 
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Example 10-10 SHOW SYSTEM/NODE Command 


$ SHOW SYSTEM /NODE= (HARLEY, WAITER) 


VAX/VMS V5.3-2 
Process Name 


Pid 
26E00041 
26E00084 
26E00085 
26E00047 
26E00048 
26E00049 
26EQO04A 
26E0004B 
26E0004C 
26E0004D 
26EOQO04E 
26E0004F 
26E00050 
26E00054 
26E00096 
26E00058 
26E00059 


VAX/VMS V5.3-2 
Process Name 


Pid 
23800081 
23800087 
23800088 
23800089 
2380008A 
2380008B 
2380008C 
2380008D 
2380008E 
2380008F 
23800090 
23800091 
23800099 
23802227 
23801DA8 
23801CAE 
23800AB4 
23801E36 
23800D40 
238022C2 
238014C3 
23801EC9 
238015D0 
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SWAPPER 
DECWSWM_ 1 


MOONSAKA_SM1 


ERRFEMT 


CACHE SERVER 
CLUSTER SERVER 


OPCOM 


AUDIT_SERVER 
JOB_CONTROL 


CONFIGURE 
SMISERVER 
NETACP 
REMACP 
DTPQUEMAN 
DECWSTE_1 


DECWSSERVER_0 


MOONSAKA 


SWAPPER 
ERRFMT 


CACHE_SERVER 
CLUSTER_SERVER 


OPCOM 


AUDIT SERVER 
JOB_ CONTROL 


CONFIGURE 
SMISERVER 


SYMBIONT_ 0001 


NETACP 
REMACP 


SYMBIONT 0002 


YALAYERY 


SERVER 0032 


Judy D- 


MAIL 16539 


FULTON 
Jack 
Bette 
BUBBARD 
NORM 


NOTESSOO0A_1* 


on node HARLEY 27-AUG-1991 08:57:17.68 
State Pri I/O CPU 
HIB 16 0 0 00:00:07. 
LEF 7 52 0 00:00:07. 
LEF 5 419 0 00:00:28. 
HIB 8 559 0 00:00:03 
HIB 16 12 0 00:00:00. 
HIB 10 322 0 00:00:08 
HIB 8 266 Q 00:00:10. 
HIB 10 42 0 00:00:01. 
HIB 10 1493 0 00:00:13. 
HIB 10 131 0 00:00:00. 
HIB 9 581 0 00:00:06 
HIB 10 119 0 00:04:17 
HIB 8 8 0 00:00:00. 
LEF 5 33 O 00:00:00. 
LEF 6 2721 0 00:00:37 
HIB 6 5218 0 00:00:59 
LEF 4 168 0 00:00:04. 

on node WAITER 27-AUG-1991 08:57:18.60 
State Pri I/Oo CPU 
HIB 16 0 0 00:00:34. 
HIB 8 20113 O 00:00:55. 
HIB 16 1383 0 00:00:01. 
CUR 9 4303 0 00:01:14 
HIB 9 9233 0 00:01:14. 
COM 11 1601 QO 00:00:04. 
HIB 9 347119 0 00:23:36. 
HIB 10 348 0 00:00:00 
HIB 9 4566 0 00:00:24 
HIB 5 2063 0 00:00:17 
HIB 10 165602 0 01:09:59 
HIB 8 906 0 00:00:01 
HIB 4 362 0 00:00:04 
LEF 4 5832 0 00:00:15. 
LEF 6 4556 0 00:00:25. 
LEP 9 4147 0 00:00:14 
LEF 6 1463 0 00:00:07. 
LEF 4 743 0 00:00:06. 
HIB 7 713 0 00:00:04 
LEF 5 28464 0 00:02:34 
LEF 4 1909 O 00:00:15. 
LEF 4 7820 O 00:00:54. 
HIB S 24099 0 00:01:03. 


Uptime 0O 17:47:34 
Page flts Ph.Mem 
67 0 0 
86 1286 1683 
49 9220 2734 
word 81 124 
07 62 100 
.00 126 221 
16 268 128 
07 1345 221 
90 415 455 
47 108 167 
«90 399 616 
39 78235 2048 
04 64 41 
48 215 390 
231 2395 2420 
. 86 3478 2959 
80 6174 1298 
Uptime 8 12:57:26 
Page flts Ph.Mem 
80 0 0 
02 83 135 
47 63 110 
89 135 286 
14 2845 287 
76 1379 421 
89 407 599 
.34 109 181 
240 493 Tod 
52 8606 278 
83 8984 8869 
.10 81 68 
03 801 Li6t 
13 16280 1234 
49 17685 292 N 
25 13018 660 
83 5835 543 N 
40 10467 266 
26 9588 677 
E32 56859 897 
36 14190 481 
78 56665 426 
3h 63137 448 N 


SHOW PROCESS/CONTINUOUS Command 


The SHOW PROCESS/CONTINUOUS command displays information about a particular 
process. The system updates this information every few seconds. To activate the utility, type: 


S$ SHOW PROCESS/CONTINUOUS [/ID=proc-id] [proc-name] 
To exit from the utility, tyoe the letter E. 


Example 10—11 shows the output from this utility. 


NOTE 


You must have WORLD privilege to use this command to examine any 
process on the system whose UIC is not the same as yours. 


Example 10-11 Output foom SHOW PROCESS/CONTINUOUS 


$ SHOW PROCESS / CONTINUOUS /ID=7CC 


Process MAZZE @ 17:27:29 
State LEF @ Working set 861 
Cur/base priority 9/4 @ Virtual pages 3895 
Current PC TFFEE44C CPU time 00:10:43.48 @ 
Current PSL 03c00004 Direct I/O 3691 
Current user SP 7FEF 9EBC Buffered I/O 26600 
PID 000007CC Page faults 58835 
UIC [GROUP11,MAZZE}] Event flags E0000043 
D4000002 


$1SDUA0: [SYS1.SYSCOMMON. ] [SYSEXE] MAIL.EXE 5 ] 
Notes on Example 10-11: 
@ Name of process 

Current state 

Current and base priority 


2] 
3 ] 
@ CPU time 
@ Name of image being run 
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USING THE NETWORK CONTROL PROGRAM (NCP) 
FOR MONITORING 


SHOW and LIST Commands 


The SHOW command allows the network manager to monitor network activity. 


¢ — It provides information from the volatile (memory-resident) network database 


The volatile database contains current (dynamic) information about network 
management components 


* For example: 


Status information will report current network condition 


Characteristics shows specific static attributes, such as node names and their relevant 
routing parameters, such as cost 


Summary condenses the status and characteristic information (default display) 


Counters displays error and performance statistics 


The LIST command works like the SHOW command, but LIST displays information from the 
permanent database. 


« The permanent (static) database contains values for NCP network parameters. 


¢ It is used at boot time to provide initial values for the volatile network database. 
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SHOW LINE Command 


Lines are the physical data communication paths between nodes. The network manager can 
use NCP commands to manipulate the physical lines connected to the local node, or to add a 
line without reconfiguring the node. 


identifying Lines 
Every line on a node must have a unique identifier. A line identifier is in the format: 


dev-c[-u] 


The parts of the line identifier are explained in Table 10-4. 


Table 10—4 Line Identification 
Part Function 


dev Mnemonic for a communications interface device, for example: 


BNA: Ethernet device on VAXBI bus 

QNA: Ethernet device on Q—bus 

SVA: Ethernet device on MicroVAX 2000 system 
UNA: Ethernet device on UNIBUS 

MFA: FDDI device on XMI 

DMB: DMB32 synchronous device 

DMC: DMC11 or DMR11 synchronous device 
Cl: computer interconnect 


Cc Represents a decimal number (0 or a positive integer) designating the device’s 
hardware controller. 
u Represents a decimal unit or line number (0 or a positive integer) included if the 


device is a multiple unit line controller. 


Example 10-12 Identifying Lines 


NCP>SHOW KNOWN LINES 
Known Line Volatile Summary as of 26-AUG-1991 11:39:09 
Line State 


QNA-0 on 
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Circuit Commands 


Circuits are virtual connections between nodes. The network manager can use NCP commands 
to manipulate all circuits connected to the local node or to add a circuit without reconfiguring 
the node. 


Identifying Circuits 
Each circuit on a node must have a unique identifier. A circuit identifier is in the format: 


dev-c or dev-c-u 


Table 10-5 explains the parts of the circuit identification. 


Table 10-5 Circuit Identification 


Part Function 
dev Mnemonic for a communications interface device. 
Cc Represents a decimal number (0 or a positive integer) designating the hardware 


controller for the device. 


u Represents a decimal unit or circuit number included only if there is more than 
one unit associated with the controller. 


To display the circuits connected to a node, use the SHOW KNOWN CIRCUITS command, as 
illustrated in Example 10-13. 


Example 10-13 Showing Known Circuits 


NCP>SHOW KNOWN CIRCUITS 


Known Circuit Volatile Summary as of 27-AUG-1991 11:51:20 


CLECULE State Loopback Adjacent 
Name Routing Node 
QNA-0 on 13.802 (PANHED) 
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SHOW LINKS Command 


The following is an extract from NCP>HELP SHOW LINKS 


Use the SHOW LINKS command to 


display link information 
volatile database) available 


(from the 
to the executor node. 


SHOW KNOWN LINKS 


CHARACTERISTICS TO file-id 
KNOWN LINKS WITH NODE node-id STATUS 
LINK number SUMMARY 


Example 10-14 Showing Logical Links 


NCP>SHOW KNOWN LINKS 


Known Link Volatile Summary as of 27-AUG-1991 18:19:58 
Link Node 
24746 


PID Process 


Remote link Remote user 
26.974 (HARLEY) 20200053 REMACP 


8203 MOONSAKA 


NCP>TELL HARLEY SHOW LINK 8203 


Link Volatile Summary as of 27-AUG-1991 18:20:07 


Link Node PID Process 


Remote link Remote user 
2180011F _TWA8: 


8203 13.802 (PANHED) 24746 CTERM 
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USING SHOW CLUSTER IN A VAXcluster SYSTEM | 


SHOW CLUSTER displays a variety of information about the cluster. 
There are two types of displays: 

* One time display (SHOW CLUSTER) 

* Dynamic display (SHOW CLUSTER/CONTINUOUS) 


The SHOW CLUSTER display can be modified to include any desired information. 
Example 10-15 The Default SHOW CLUSTER Display 


$ SHOW CLUSTER 


View of Cluster from system ID 1025 node: BARNUM 12-JUN-1991 17:09:35 
$------- == ------ = - - --- -- -- = = + 
| SYSTEMS | MEMBERS | 
$----------------~------------ + 
| NODE | SOFTWARE | STATUS | 
$----------------------------- + 
BARNUM | VMS V5.4 | MEMBER 
CLOWN | HSC V390 | 


| 
| 
BAILEY | VMS V5.4 | MEMBER | 
HIWIRE | HSC V390 | | 
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Adding and Removing from the Display 


Example 10-16 SHOW CLUSTER Output (Transition Time) 


Command> REMOVE MEMBERS 
Command> ADD TRANSITION TIME 


View of Cluster from system ID 1126 node: BARNUM 12-JUN-1991 15:31:13 


+—------- frome e------------- + 
| SYSTEMS} MEMBERS | 
+-------- $----------------- + 
| NODE | TRANSITION TIME | 
+-------- $o------------- == + 
| BARNUM | 29-APR-91 21:19 | 
| BAILEY | 3-MAY-91 08:56 | 
| CLOWN | | 
| HIWIRE | | 
+-------- $----------------- + 
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SHOW CLUSTER Initialization Files 


The SHOW CLUSTER utility enables you to specify an initialization file to be used when the 
utility is invoked. 


¢ Define the logical name SHOW_CLUSTER$INIT to point to this file 
¢ Invoked by the DCL command: SHOW CLUSTER 
— Or use @filename from the Command> prompt 


¢ The sample initialization file (SHOW _CLUSTER.COM) shown in Example 10-17 was 
created with the SAVE command, and illustrates the command format 


¢ Example 10-18 shows the display that is defined by the sample 


Example 10-17 A Sample SHOW CLUSTER Initialization File 


INITIALIZE 

REMOVE SYSTEMS 

REMOVE SYSTEMS /ID = %SXO0QQQQ000FCD7 

REMOVE SYSTEMS /ID = %X000000007311 

ADD CL_ MEMBERS, LAST TRANSITION, NODE, HW_TYPE 
SET CL_MEMBERS /WIDTH = 6 

WRITE CLUSTER2 OUT 


Example 10-18 Display Resulting fom SHOW_CLUSTERSINIT 


View of Cluster from system ID 69397 node: HANDLE 


$onn--- == == + $o---+ = $2 + + 
| SYSTEMS | MEMBERS | | CLUSTER 

penne o-- poowa+- +--+ += $uoe------ $$a-----~-- pono -~-- +--+ + 
| NODE | HW TYPE | STATUS || CL MEMB | LAST TRANSITION | 
+-------~ $oeee a =--- a ee $--------- +--+ $ooae- Le at in es + 
| HANDLE | VAXstation 3100/GPX | MEMBER || 5 | 25-JUN-91 09:43 | 
| JELLY | VAX 8550 | MEMBER |+-----~---- pean ee eae ee + 
| WIZARD | VAX 6000-420 | MEMBER | 

| FARMS | VAX-11/785 | BRK_NON | 

a $a eae nnn +--+ $-------~- + 
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You can control the SHOW CLUSTER display with the commands listed in Table 10-6. 


Table 10-6 Basic SHOW CLUSTER Commands 


Command 
ADD 
REMOVE 
SET 
INIT 
HELP 
EXIT 
SAVE 


WRITE 
@filespec 


Description 

Add a class or field to the display 

Remove a class or field from the display 
Change the width or characteristics of a field 
Reset the display to the default state 

Enter interactive help mode 

Exit the display _ : 


Create a command procedure SHOW_CLUSTER.COM, which recreates 
the state of your screen 


Write current data to a file for problem reports 
Execute a command procedure of SHOW CLUSTER commands 


* SHOW CLUSTER does not automatically prompt for commands. 


« Press CTRL/U to see the SHOW CLUSTER prompt (Command>). 


¢ You can also enter a command when the prompt is not visible. 
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SUMMARY 


The VMS operating system provides many methods for examining system activity. Table 10-7 
lists some commands and utilities you can use for this purpose. 


Some of these commands were covered in other chapters of this course. 


Table 10-7 System, Process, and Device Monitoring 


Information Displayed 


Command or Utility 


General System Information 


Overview of the processes on the system 
Overview of print queues 
Overview of batch queues 


Overview of mounted disk and tape 
volumes 


Overview of system memory resources 
Demands on system resources 


Error counts for CPU, memory, and 
physical devices 


Cluster activity and performance 


$ SHOW SYSTEM 

$ SHOW QUEUE/DEVICES/ALL 
$ SHOW QUEUE/BATCH/ALL 

$ SHOW DEVICES/MOUNTED 


$ SHOW MEMORY 
$ MONITOR 
$ SHOW ERROR 


$ SHOW CLUSTER 


Specific Information (Process or Device) 


Interactive users, terminal names, and 
process IDs 


Information about current activities of a 
certain process 


Information about user limits and 
privileges 


Information about disk space allowances 


Consumption of resources by processes 
Information about devices and volumes 
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$ SHOW USERS 


$ SHOW PROCESS/CONTINUOUS/ID=pid 
$ SHOW PROCESS/ALL/ID=pid 


$ RUN SYS$SYSTEM:AUTHORIZE 


$ SHOW QUOTA /USER=[uic] 
$ RUN SYS$SYSTEM:SYSMAN 


$ ACCOUNTING 
$ SHOW DEVICE device 


APPENDIX 


Monitoring the System Command Procedures 


SUBMON.COM executes the data collector command file (MONITOR.COM) 


- Logicals SYS$MONITOR and MONITOR$ARCHIVE must be defined in 
SYS$COMMON:[SYSMGRJSYLOGICALS.COM 


¢ All three command procedures; SUBMON.COM, MONITOR.COM, and MONSUM.COM 
must be placed in the directory SYS$MONITOR 


* A @SUBMON.COM command must be added to SYS$COMMON:[SYSMGR]JSYSTARTUP__ 
V5.COM to be invoked at system startup 


¢ MONITOR.COM and MONSUM.COM must be edited 


— Change CLUSTER_MANAGER to your user name or SYSTEM 


¢ MONITOR.COM prime time hours may need to be modified for your site 


Example 10-19 SUBMON.COM 


: 
: 
f 
: 
: 
: 
: 
: 
! 
t 
! 
! 
' 
t 


WMUNMYNMOMAMUNNUNNDUMNN 


RUN 


MUNN DN 


Copyright (c) 1987 Digital Equipment Corporation. All rights reserved. 
SUBMON.COM (Submit MONITOR.COM file) 


This command file is to be placed in a cluster-accessible 
directory called SYSSMONITOR. At system startup time, for 
each node, it is executed by SYSTARTUP.COM, following logical 
name definitions for the cluster-accessible directories, 
SYSSMONITOR and MONSARCHIVE. 


Submit detached MONITOR process to do continuous recording. 


SYSSSYSTEM: LOGINOUT.EXE - 
/UIC=[1,4] = 
/INPUT=SYSSMONITOR:MONITOR.COM - 
/OUTPUT=SYSSMONITOR:MONITOR.LOG - 
/ERROR=SYSSMONITOR:MONITOR.LOG - 
/PROCESS NAME="Monitor" - 
/WORKING SET=100 - 

/MAXIMUM WORKING SET=100 - 
/EXTENT=512 - 

/NOSWAPPING 


! End of SUBMON.COM 
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Example 10-20 MONITOR.COM 


WMUNDMANMAMONVUNNANNUNNMNNUNNNUNNUNYNVNMNMNUMN NHN MN HUMUNUHNYYNMAYDB 


Copyright (c) 1987 Digital Equipment Corporation. All rights reserved. 
MONITOR.COM (Generate MONITOR recording file) 


' 
! 
! 
! 
! This command file is to be placed in a cluster-accessible 
! directory called SYSSMONITOR. At system startup time, for each 
! node, it creates in SYSSMONITOR a MONITOR recording file, which 
! is updated throughout the life of the boot. It also creates in 
! MONSARCHIVE, a summary file from the recording file of the 
! previous boot, along with a copy of that recording file. 
! Logical name definitions for both cluster-accessible directories, 
! SYSSMONITOR and MONSARCHIVE, must be included in SYSTARTUP.COM. 

! 
SET DEF SYSS$MONITOR 
SET NOON 
PURGE MONITOR. LOG/KEEP:2 

1 

: 

! Compute executing node name and recording and summary 

! file names (incorporating node name and date). 

! 
NODE = FSGETSYI ("NODENAME" ) 
DAY = FSEXTRACT(0,2,FSTIME () } 
IF FSEXTRACT(0,1,DAY) .EQS. " " THEN DAY = FSEXTRACT (1,1, DAY) 
MONTH = FSEXTRACT (3,3,FSTIME() ) 
ARCHFILNAM = "MONSARCHIVE:"+NODE+" MON"+DAY+MONTH 
RECFIL = NODE+" MON.DAT" 


SUMFIL = ARCHFILNAM+".SUM" 
! 


Hl 


: 
! 
: 
! Check for existence of recording file from previous boot 
! and skip summary if not present. 


! 


OPEN/READ/ERROR=NORECFIL RECORDING ‘’RECFIL’ 


CLOSE RECORDING 
' 
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Example 10-20 MONITOR.COM (Cont) 


{ 
! Generate summary file from previous boot 
! . 
MONITOR /INPUT='’RECFIL’ /NODISPLAY /SUMMARY='SUMFIL’ - 


ALL_CLASSES, DISK/ITEM=ALL, SCS/ITEM=ALL 
! 


MMMM 


t 
! Compute subject string and mail summary file to cluster manager 
! 


A= wernt 
="" MONITOR Summary " 
SUB = A+NODE+B+FSTIME ()+A 
MATL/SUBJECT=’ SUB’ ‘’SUMFIL’ cluster manager 
! 
! 
! Archive recording file and delete it from SYSSMONITOR. 
! 
COPY ’RECFIL’ ’ARCHFILNAM’ .DAT 
DELETE ‘'RECFIL’;* 
! 
NORECFIL: 


SET PROCESS/PRIORITY=15 
! 


t 
! Begin recording for this boot. The specified /INTERVAL value 

! is adequate for long-term summaries; you may require a smaller 
! value to get reasonable "semi-live" playback summaries (at the 
! expense of more disk space for the recording file). 

t 


MONITOR /INTERVAL=600 /NODISPLAY /RECORD=’RECFIL’ ALL CLASSES 
! 


End of MONITOR.COM 


MAM DMNA NNMNNMNMNUMN MUNN NNN DHA MYM WYN YHUNUNYNDM 


: 
: 
, 
! 
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Example 10-21 MONSUM.COM 


DAMM MONOANANAYNUMOYMNUMYNYNYNUNNTYNNUNM 


MOANMNNNMMMMNNNUNANAUNNMH 


MMMM MNUNNNUNYUNYD 


Copyright (c) 1987 Digital Equipment Corporation. All rights reserved. 


MONSUM.COM (Generate cluster multi~file summaries) 


{ 

t 

! 

' 

! This command file is to be placed in a cluster-accessible directory 

! called SYSSMONITOR and executed at the convenience of the cluster 

! manager. The file generates both 24-hour and "prime time" cluster 

! multi-file summaries and resubmits itself to run each day at midnight. 
SET DEF SYSSMONITOR 

SET NOON 


! Compute file specification for MONSUM.COM and resubmit the file. 


FILE FSENVIRONMENT ("PROCEDURE") 
FILE = FSPARSE (FILE,,, "DEVICE")+FSPARSE (FILE,,,"DIRECTORY") +FSPARSE (FILE,,,"NAME") 


SUBMIT ‘/FILE’ /AFTER=TOMORROW /NOPRINT 
' 


! Generate 24-hour cluster summary. 

t 

: 
MONITOR/ INPUT= (SYSSMONITOR: *MON* .DAT; *, MONSARCHIVE: *MON* .DAT;*) - 
/NODISPLAY/SUMMARY=MONSUM.SUM - 

ALL_ CLASSES, DISK/ITEM=ALL, SCS/ITEM=ALL - 


/BEGIN="YESTERDAY+0:0:0.00" /END="TODAY+0:0:0.00" /BY NODE 
! 


! 

! Mail 24-hour summary file to cluster manager and delete the file from 
! SYSSMONITOR. 
{ 
! 
{ 


MAIL/SUBJECT="Daily Monitor Cluster-wide Summary" MONSUM.SUM cluster manager 
DELETE MONSUM. SUM; * 

{ 

! Generate prime-time cluster summary. 

! 

: 
MONITOR/ INPUT= (SYSSMONITOR: *MON* . DAT; *, MONSARCHIVE: *MON* .DAT;*) —- 
/NODISPLAY/SUMMARY=MONSUM.SUM - 

ALL CLASSES, DISK/ITEM=ALL,SCS/ITEM=ALL - 


/BEGIN="YESTERDAY+9:0:0.00" /END="YESTERDAY+18:0:0.00" /BY_NODE 
' 


' 

! Mail prime-time summary file to cluster manager and delete the file 
! from SYSSMONITOR. 
' 
t 


MAIL/SUBJECT="Prime-Time Monitor Cluster-wide Summary" MONSUM.SUM cluster manager 
DELETE MONSUM. SUM; * 
! 


! End of MONSUM.COM 
! 
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Command Procedure for Monitoring the VAXcluster System 


Example 10-22 Command Procedure for MONITOR Recording 


$! Get the node name to use in the recording file name 


$! 

$ NODE :== FSGETSYI ("NODENAME") 

$! 

$! Record disk I/O rates for the next hour 
$! 


$ MONITOR /NODISPLAY /END="+1:00" /RECORD=’NODE’ .MON DISK 


Exampie 10-23 Procedure to Start Recording on Two Nodes 


S$! Record data in batch on node BARNUM 


$! 

$ SUBMIT / QUEUE=BARNUM_BATCH RECORD.COM 
$! 

$! Record data in batch on node BAILEY 
$! 


$ SUBMIT /QUEUE=BAILEY BATCH RECORD.COM 


Example 10-24 Two-Node MONITOR Summary 


S MONITOR /SUMMARY /BY NODE /INPUT=(BARNUM.MON,BAILEY.MON) /NODISPLAY DISK 
S$ TYPE MONITOR.SUM 

a ata VMS Monitor Utility 

| AVE | DISK I/O STATISTICS 

SSS MULTI-FILE SUMMARY 

I/O Operation Rate 


Node: BARNUM BAILEY 

From:27-AUG-1991 15:06 27-AUG-1991 15:06 Row Row Row Row 
To: 27-AUG-1991 16:06 27-AUG-1991 16:06 Sum Average Minimum Maximum 
$S1SDUA0: 0.34 0.00 0.3 0.1 0.00 0.34 
$1SDUA1: 0.02 1.01 1.0 0.5 0.02 1.01 
$1SDUA2: L143 3.48 4.6 2.3 1.13 3.48 
S1SDUA3: 8.24 12.42 20.6 10.3 8.24 12.42 
S2SDUA0: 0.00 0.00 0.0 0.0 0.00 0.00 
$2SDUAI1: 0.00 0.00 0.0 0.0 0.00 0.00 

NOTE 


This example does not show the entire display because it would require 
132 columns. 
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Developing Command Procedures 


INTRODUCTION 


The Digital Command Language (DCL) allows the system manager to communicate with the 

VMS operating system. DCL provides an extensive set of commands to get information about 
the system and modify work environments. It also provides data manipulation and flow-control 
mechanisms similar to those found in programming languages, so that a command procedure 
can function as a sophisticated application program. 


The system manager can create complex DCL procedures to automate frequently performed 
tasks, such as maintaining user accounts, monitoring resources, and controlling security. 


This chapter reviews concepts used in developing command procedures and introduces several 
advanced features. 


OBJECTIVES 


To automate frequently performed tasks, the system and network manager should be able to 
write command procedures that: 


e« Use parameters 

¢ Use terminal I/O to communicate with the user 

¢- Use symbols to manipulate and compare data items 
* Control the flow of execution 


¢ Use several commonly used lexical functions to obtain information about the system 
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RESOURCES 


°* Guide to Using VMS Command Procedures 
¢ VMS DCL Dictionary 


TOPICS 


« Review of command procedure guidelines 

* Passing parameters to command procedures 
¢ More on symbols 

* Terminal I/O 

¢ More uses for symbols 

¢ Controlling the flow of execution 

« Using lexical functions to manipulate data 


¢ Appendix — advanced DCL topics 
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REVIEW OF COMMAND PROCEDURE GUIDELINES 


Steps for Developing Command Procedures 


1. Design the command procedure. 
¢« Determine what tasks the procedure should perform. 
*« Decide what results the procedure should produce. 
2. Create the command procedure. 
« Use the text editor of your choice. 
* Specify the file tyoe .COM for the command procedure. 
3. Execute and test the command procedure. 
* Use the "at" sign (@), followed by the name of the command procedure. 
$ @LOGIN.COM 
¢« Use the DCL command SET VERIFY to: 
— Display each line of the procedure as it executes 
— Help you locate errors if they occur 
4. Modify and retest the command procedure, if necessary. 
« Repeat steps 2 and 3. 


* Use the DCL command SET NOVERIFY after the procedure has been tested and 
perfected. 


5. Add comments to the command procedure so it is easy to read and maintain. 
¢« Describe the procedure in detail. 
¢ Describe any parameters that are passed to the procedure. 


¢ Put lengthy comments either at the end of a procedure (after $EXIT) or at the beginning 
(skip it with a GOTO) for performance enhancement. 
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Example 11-1 A Formatted Command Procedure 


S$! DA TILY.cCOM 
S$! 
$! Comment Section 


$! 


$! DAILY.COM gathers information from the system. 
$! information is displayed on the terminal or in the 


S$! DAILY.LOG file if used in batch mode. 


$! 

$! Author: 

$! Modification History: 

$! Person Date Change 
$! 

$ SET NOON 

$! 

$! Initialization Section 

$! 

$ SHOW TIME 

$! 

$! Main Section 

$! 

$! Capture information on the system 
$! 


$ SHOW QUOTA 

$ SHOW USERS/FULL 

$ SHOW PROCESS/ALL 

$ DIR/GRAND_TOTAL/SIZE=ALL [...] 


$! 

$! Find files added and/or changed 

oa 

$ DIRECTORY/MODIFIED/SINCE=YESTERDAY [...] 
$! 

$! Cleanup Section 

$! 

$ EXIT 
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PASSING PARAMETERS TO COMMAND 
PROCEDURES 


You can specify up to eight parameters to a command procedure at execution time. 


This allows you to supply the names of files, other procedures, variable values, and other 
possible values on the command line. 


¢ Format: 
$ @filename.com parameter _1 parameter 2 ... parameter 8 
¢« Note that the parameter values are delimited by spaces. 


¢ If you specify parameters when you execute the command procedure, the system 
assigns the values you specify to the local symbols P1 - P8. 


Within the command procedure, symbol! substitution is the usual method of including the 
parameter’s value in a command line. 


— Enclose the symbol name in apostrophes (’). 


— Within a character string, precede the symbol with two apostrophes (”) and end the symbol 
with a single apostrophe (’). 
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Example 11-2 Passing a Parameter to a Command Procedure 


DMMDNNNMNNUNANUNUNNMNDNMNYNNMNUVNMNYNUYNUMNUNNN 


REPORT2.cCOM 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Changing your default directory" 


Set your default to the correct subdirectory 
SET DEFAULT DISK1: [REPORTS.’P1’ ] 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Printing the '’P1’ report" 


Print out the report for the correct day 
PRINT ’P1’.RPT 


Return to your login device and directory 
WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Changing back to your login directory" 


SET DEFAULT SYSSLOGIN 
EXIT 


This command procedure sets your default directory to the [REPORTS.’P1’ ] 
subdirectory, prints out a report for the day of your choice, returns you 
to your login device and directory, then exits. 


Execution of REPORT2.COM: 


@s @REPORT2 TUESDAY 


Changing your default directory 
Printing the TUESDAY report 


Job TUESDAY (queue SYSSPRINT, entry 47) started on WORK_TXAO 


Changing back to your login directory 


Notes on Example 11-2: 


.2 


Force symbol substitution for P1, the first (and only, in this example) parameter passed on 
the command line. 


Here is where the parameter is passed to the command procedure. 


Because TUESDAY is the first thing on the command line after the name of the command 
procedure, it becomes the value of P1. 
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MORE ON SYMBOLS 


As discussed earlier, you can use symbols in many ways in command procedures. DCL 
translates symbols into their corresponding values. 


* Some DCL commands automatically replace symbols with their values. 
« Most DCL commands do not perform automatic symbol substitution. 
¢ To force symbol substitution wnen DCL is not expecting to encounter a symbol: 
— Enclose the symbol name in apostrophes (’). 
— Inacharacter string, precede the symbol with two apostrophes (”) and end the symbol 


with a single apostrophe (’). 


Table 11-1 Symbol Substitution Techniques 
Automatic Substitution 


Command synonym (first item after $ prompt) $ XX = "DELETE" 
: $ XX FILE-TXT;1 


In the right-hand side of an = or == assignment $ COUNT = COUNT + 1 
statement $ FILESPEC = NAME + ".TXT" 
In an IF, WRITE, or INQUIRE command $ IF COUNT .GT. 10 THEN - 


WRITE SYSSOUTPUT COUNT 


Forced Substitution 


In a DCL command that does not perform automatic $ RUN 'P1’ 
symbol substitution 


In a character string $ WRITE SYSSOUTPUT - 
"The file ’’P2' exists." 


Concatenating two symbols in a DCL command that $ PRINT ‘NAME’ .' TYPE’ 
does not perform automatic symbol substitution 
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Example 11-3 Using Symbol Substitution 


REPORT3.COM 


This command procedure sets your default directory to the 
[REPORTS.’DAY’] subdirectory, prints out a report for the 
day of your choice, returns you to your login device and 
directory, then exits. 


ee a ee ee ee ee ee 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Day to print report for: ’’Pl’ " 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Changing your default directory" 


! Set your default to the correct subdirectory 
SET DEFAULT DISK1: [REPORTS.’P1’ ] 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Printing the ’’P1’ report" 


! Print out the report for the correct day 
PRINT. “Pils ,RPT 
! Return to your login device and directory 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Changing back to your login directory" 


SET DEFAULT SYSSLOGIN 
EXIT 


DAN MMADMMDAMUMADUNUNNNUNNUNUNUNUNNDNUMNAYNUNNUHNUNYNUNNUND 


Execution of REPORT3.COM: 


$ @REPORT3 

Day to print a report: TUESDAY 

Day to print report for: TUESDAY 

Changing your default directory 

Printing the TUESDAY report 

Job TUESDAY (queue SYSSPRINT, entry 47) started on WORK_TXAO 


Changing back to your login directory 
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TERMINAL I/O 


Terminal I/O allows you to write command procedures that interact with the user. You can 
prompt the user to type information at the keyboard and then use that information in the 
command procedure. You can process information typed at the keyboard and send it back to 
the user, for verification, for example. 

Terminal input and output can be used to: 

¢ Prompt the user for information 

¢ Allow the use of an interactive utility, such as an editor 

¢- Display messages and command output on the terminal screen 


¢« Redirect terminal output to a file 

A simple example of terminal I/O is the creation and use of a menu for a user to select choices 
from. You can create a menu by displaying formatted text on the screen. Then you can capture 
the number or letter of a selection displayed as the user types it. Using that selection you 
can then have the command procedure execute the command procedure that carries out the 
selected task. 


Figure 11-1 How Menu Selection Can be Used to Run Command Procedures 


MENU.COM 


Display the menu file 
User enters a selection 


Run selected COM file 





ZKO-055-000056-11-PSA 
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Controlling Terminal 1/O 


You control terminal I/O by redefining the same logical names that DCL uses to obtain and 
display information for your process. These logical names are used interactively to communicate 
with your process when you are typing at your terminal. 


In similar fashion, in a command procedure, they can be used to enable communication 
between the command procedure and the system. 


Table 11-2 Logical Names Used with I/O 


Logical Name 
SYS$COMMAND 


SYSS$INPUT 


SYSS$OUTPUT 


SYS$ERROR 


Description 


Where the system 
expects commands 
to come from 


Where the system 
expects to see input 
data come from 


Where the system 
expects to display 
the results of any 
command 


Where the system 


expects to write error 


messages 


Interactive 


Terminal 


Terminal 


Terminal 


Terminal 


Batch 


Disk where 
command 
procedure 
resides 


Disk where 
command 
procedure 
resides 


Disk where 
log file 
resides 


Disk where 
log file 
resides 


Command 
Procedure 


Terminal 


Disk where 
command 
procedure 
resides 


Terminal 


Terminal 


* You can redefine the values of these logical names to control terminal \/O in a commane 


procedure to perform terminal and file I/O tasks such as: 


— Sending output to a file instead of to your terminal 


— Getting a command from a file 


— Getting input from a data file 


« You do not have to open or close files associated with terminal 1/0. DCL opens and closes 
them automatically. 
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Displaying Information for the User on the Terminal 


Use either the WRITE or the TYPE command to display information at the terminal. 


The WRITE Command 
¢ Format: 
$ WRITE SYSSOUTPUT expression 
¢ The expression can be: 
— Acharacter string, enclosed in quotation marks 
S WRITE SYSSOUTPUT "Hello" 
— Asymbol name (The symbol’s value is automatically substituted.) 
$ WRITE SYSSOUTPUT X 
— A lexical function 
S$ WRITE SYSSOUTPUT FSTIME() 
— Acombination of items separated by commas 


$ WRITE SYSSOUTPUT "The sumis ",X 


Developing Command Procedures 11-13 


Example 11-4 Using WRITE SYS$OUTPUT to Display a User Menu 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT 
WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT 
WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT 
WRITE SYSSOUTPUT "" 


SELECT AN ITEM:" 


- 
= 


1. ENTER DATA AT THE TERMINAL" 


- 
= 


2. ENTER NAME OF DATA FILE" 


WMMMMAUMMNUN NUNN 


Example 11-5 Output from the WRITE SYSS$OUTPUT Command Fragment 


SELECT AN ITEM: 


1. ENTER DATA AT THE TERMINAL 
2. ENTER NAME OF DATA FILE 
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Getting Information from the User 


Use either the INQUIRE or the READ command to solicit information from the user. 


The INQUIRE Command 


Format: 

$ INQUIRE symbol-name "prompt" 
Example: 

S$ INQUIRE NAME "Enter filename" 
The prompt string is optional. 


The user’s response is converted to uppercase. Multiple blanks and tabs are replaced with 
a single space. 


The symbol is equated to the user’s response. 


The /NOPUNCTUATION qualifier prevents the display of a colon (:) after the "prompt" 
string. 


The READ Command 


Format: 
$ READ[/PROMPTs=string] SYS$COMMAND'-  symbol-name 
Example: 
S$ READ/PROMPT="Enter filename" SYSSCOMMAND NAME 
The user’s response is not converted to uppercase, and multiple spaces are not removed. 


The symbol is equated to the user’s response. 
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Example 11-6 Terminal I/O in Command Procedures 


$! To.coOmM 
$! Demonstration of simple terminal I/O. 
$ TYPE SYSSINPUT 

@ Using INQUIRE 


S$ INQUIRE YOU1L "Please type your name" 
@s WRITE SYSSOUTPUT YOUI1," is using this terminal." 


$ WRITE SYSSOUTPUT "" ! Blank line. 

$! 

$! 

$ WRITE SYSSOUTPUT "Using READ" 

$ WRITE SYSSOUTPUT "" 

$ READ/PROMPT="Please type your name" SYSSCOMMAND YOU2 
$ WRITE SYSSOUTPUT YOU2," is using this terminal." 

$ WRITE SYSSOUTPUT "" 

$ EXIT 


Sample run of |O.COM: 


$ @I10 
Using INQUIRE 


@ Please type your name: Fred Apon 
@ FRED APON is using this terminal. 


Using READ 


© Please type your name Fred Apon 
@ Fred Apon is using this terminal. 


$ 


Notes on Example 11-6: 


@ This is a data line, therefore it does not begin with a dollar sign. The next line, a command 
line, begins with a dollar sign and terminates the data for TYPE. 


@ The output is a combination of a symbol and some text. Separate the symbol and the text 
with a comma. 


© 


INQUIRE adds a colon and a space to the prompt. (You can suppress the colon with 
INQUIRE/NOPUNCTUATION.) 


INQUIRE converts input to uppercase and reduces multiple spaces to one space. 
This blank line is the result of WRITE SYS$OUTPUT "". 


Punctuation or spacing is not supplied by READ. 


oe © @ 6 


READ preserves the case and spacing of the input. 
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MORE USES FOR SYMBOLS 


Symbols can be used in a variety of ways. The examples listed below briefly show some of 
these uses. Some of these examples are familiar to you, and some are new. 


Variables in command procedures 
— S$ cCOUNT=1 


— lf you need to count how many times a task is repeated, you can assign some symbol 
"COUNT" to one and then increment it by 1 each time the task completes. 


Reference to data records in a command procedure 
— $$ READ INPUT_FILE RECORD 


— Your command procedure would read the contents of INPUT_FILE and store it in the 
symbol RECORD. 


Parameters to command procedures 
— $ @DOIT.COM DATA.DAT DATA DONE. DAT 


—  DATA.DAT and DATA_DONE.DAT are values for the symbols P1 and P2, which you 
can use to pass information to a command procedure on the command line (in this 
case, the input file and the output file for the procedure). 
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Symbols Used as Variables in Command Procedures 


One of the most common uses for symbols in command procedures is as variables. You can 
think of variables as place holders for values that the command procedure needs to perform a 
specific task. 


For instance, a variable named COUNT could be defined and used to help the command 
procedure know how many times it has completed a certain task. When you and | doa 
repetitive task, we just keep count in our heads; but a command procedure can’t do that. It 
needs a variable like COUNT that it can keep adding to, to keep track of how many times it has 
done something. 


To use a symbol as a variable: 
1. Initialize the symbol 
— Makes sure that no value has been assigned before 
— Defines the symbol for the command procedure 
— $§ COUNT =0 
2. Use the value of COUNT — Possible uses include: 
—  Incrementing COUNT at the end of every loop of a repetitive task 
$ COUNT = COUNT+1 
—- Using it in the assignment of other symbols 
$ SUBTOTAL = COUNT+1 
— Using it in the assignment of string variables 
$ PARAM := P’ COUNT’ 
PARAM now equals P1 
Must use := or :== with strings (local or global) 


Must use apostrophes to force symbol substitution 
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Using Symbols to Manipulate Data 


You can use symbol operations in a number of ways to manipulate data in a command 
procedure. For example, you could: 


* Take a single word from a data record and combine it with a word or words from another 
data record to create a new record or write a report record 


¢« Remove part of a word or replace parts of words to create a new character string 


¢ Compare strings to test whether the data is what you expected and based on the outcome 
of that test either do the task or stop the command procedure 


* Perform simple arithmetic 


These possible tasks may seem rather sterile. However, by applying such simplistic tasks to 
text in records and files, you can achieve almost any text manipulation task that you need. 
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Manipulating Strings 


You can use these operators to perform string operations: 


+ String Concatenation 
Concatenates two character strings to form a single character string. 


- String Reduction 
Subtracts one character string from another. 


Table 11-3 Examples of String Operations 


Example Result 

A = "MYFILE" + ".MEM" "MYFILE.MEM" 
B = "FILENAME.MEM" - "FILE" "NAME.MEM" 
C = "LISTING.LIS" - "LIS" "TING.LIS" 
D="MIS"+C "MISTING.LIS" 


The following rules apply to string manipulation: 


For string concatenation or reduction to occur, all operands must be character string 
expressions. Otherwise, any string is converted to an integer and the result is an integer. 
$ X = "TESTING" + 17 


$ SHOW SYMBOL X 
x= 18 Hex = 00000012 Octal = 00000000022 


X = 18 because "TESTING" starts with the letter T, which is equivalent to "TRUE", which 
has a value of 1. 1+ 17 = 18. 


If the string following the minus sign in a string reduction operation occurs more than once 
in the preceding string, only the first occurrence is removed. 
$ Y = "TESTING" - "T" 


$ SHOW SYMBOL Y 
Y = "ESTING" 


If you wish to remove both "T"s: 


$ Y = "(RSTING" -—" Tr ope 
S$ SHOW SYMBOL Y 
Y = "ESING" 
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Manipulating Arithmetic Expressions 


An arithmetic expression can contain: 


* Integers 


¢ Lexical functions that evaluate to integers 


* Symbols that have integer values 


¢ Integer operands that are connected by arithmetic, logical, and comparison operators 


Table 11-4 Arithmetic Operators 


Operator 


+ 


Meaning 

Arithmetic sum 

Arithmetic difference 

Arithmetic unary plus (positive) 
Arithmetic unary negate (negative) 
Arithmetic product 

Arithmetic division (integer quotient) 


The following rules apply to arithmetic operations: 


¢« The result of an arithmetic operation is an integer. 


¢ All results giving decimal fractions are truncated. 


The truncation of fractional results is shown in Table 11—5. 


Table 11—5 Fractional Calculations 


Calculation 
99/100 
101/100 
199/100 


Actual Result 
.99 0 
1.01 1 
1.99 1 
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| Using Symbols to Test Data 


In addition to being able to manipulate and format data, you can use symbols to test for validity 
or for certain values to help determine what tasks are performed in a command procedure. 


Comparing Strings 


All string comparison operators end in the letter S, for "string." 


Table 11-6 String Comparison Operators 


Operator 
.EQS. 
.GES. 
.GTS. 
.LES. 
.LTS. 
.NES. 


Meaning 

String equal to 

String greater than or equal to 
String greater than 

String less than or equal to 
String less than 

String not equal to 


The following rules apply to string comparison: 


« The comparison is on a character-by-character basis, and terminates when two characters 


do not match. 


« — If one string is longer than the other, the shorter string is padded on the right with nulls (a 
numeric value of %X0Q) before the comparison is made. 


A null has a lower numeric value than any of the alphabetic or numeric characters. 


« Lowercase letters have higher numeric values than uppercase letters. 


« If the result of a comparison is true, the expression is given a value of 1. 


* — If the comparison is false, the expression is given a value of 0. 
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Table 11-7 Example Character String Comparisons 


Comparison Expression 
"MAYBE" .LTS. "maybe" 


"ABCD" .LTS. "EFG" 


"YES" .GTS. "YESS" 


"AAB" .GTS. "AAA" 


"TRUE" .EQS. 1 


“FALSE” .EQS. 0 


"123" .EQS. 123 


Result 
1 (true) 


1 (true) 


0 (false) 


1 (true) 


0 (false) 


0 (false) 


1 (true) 


Explanation 


The expression is true because the numeric 
value of "M" is less than that of "m." 


The expression is true because the numeric 
value of "A" is less than that of "E." 


The expression is false because the numeric 
value of a null character is less than that of 
"S". (The "YES" was padded on the right 
with a null.) 


The expression is true because the numeric 
value of "B" is greater than that of "A." 


DCL converts the integer 1 to the string "1" 
before comparing the numeric value of "T” to 
the numeric value of "1." 


DCL converts the integer 0 to the string "0" 
before making the comparison. 


DCL converts the integer 123 to the string 
"123" before making the comparison. 
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Comparing Arithmetic Expressions 


The result of an arithmetic comparison is an integer. Use the arithmetic comparison operators 
shown in Table 11-8 to compare integer values. 


Table 11-8 Arithmetic Comparison Operators 


Operator 
EQ. 
GE. 
.GT. 
EE; 
LT. 
NE. 


Meaning 

Arithmetic equal to 

Arithmetic greater than or equal to 
Arithmetic greater than 

Arithmetic less than or equal to 
Arithmetic less than 

Arithmetic not equal to 


The following rules apply to arithmetic comparisons: 


¢ Operands in arithmetic comparisons are integer expressions. 


¢ If you specify a character string value as an operand, the string is converted to an integer 
value before the comparison is performed. 


¢ If a character string begins with an upper- or lowercase T or Y, the string is converted to 
the integer 1. If a string begins with any other letter, the string is converted to the integer 0. 


¢ — If a string contains numbers that form a valid integer, the string is converted to its integer 


equivalent. 


* If the result of an arithmetic comparison is true, the expression has a value of 1. If the 
result of the comparison is false, the expression has a value of 0. 
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Table 11-9 Example Arithmetic Comparisons 


Expression 
1 .LE.2- 


1 .GT. 2 


1+3 .—€Q.2+5 ° 


"TRUE" .EQ. 1 


"FALSE" .EQ. 0 


"123" .EQ. 123 


Value of 
Expression 


1 (true) 


0 (false) 


0 (false) 


1 (true) 


1 (true) 


1 (true) 


Explanation 


The expression is true because the integer 1 is less than 
the integer 2. 


The expression is false because the integer 1 is not greater 
than the integer 2. 


The expression is false because the integer 4 is not equal 
to the integer 7. 


The expression is true because the string "TRUE" is 
converted to the integer 1 for comparison with the integer 
1, and they are equal. 


The expression is true because the string "FALSE" is 
converted to the integer 0 for comparison with the integer 
0, and they are equal. 


The expression is true because the string "123" is 
converted to its integer equivalent for comparison with 
the integer 123, and they are equal. 
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\ 
CONTROLLING THE FLOW OF EXECUTION 


When you write a command procedure, you need to be able to control what commands happen 
under what conditions. For example, you might test the value of a symbol, and depending on 
that value, select different tasks to carry out. 


As another example, you can write code so that if the user provides the parameters for a 
command procedure on the command line, they will be used. If not, the command procedure 
will query the user for the information. This test is accomplished using the DCL commands that 
contro! execution flow. 


Table 11-10 Commands Used to Control Execution Flow 
Command Function 


IF Tests the value of an expression and executes the specified command or 
commands if the result of the test is true 


GOTO Transfers control to a different part of the procedure that is identified by a 
label 
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IF Command 


The IF command accepts multiple statements for execution when the condition is true (as long 
as the THEN statement is not on the same line as the condition). 


- A test of the conditional expression produces the following results: 
— If the condition is true, the command(s) following THEN are performed. 


— Ifthe condition is false, the next DCL command in sequence is performed or an optional 
ELSE statement can be performed. 


* The command(s) following THEN or ELSE can be any valid DCL command(s). 
¢ There are three formats for the IF command. 
— Format 1: 
$ IF conditional-expression THEN command 
— Format 2: 
$ IF conditional-expression 


$ THEN command 
$ command 


$ ENDIF 
— Format 3: 
$ IF conditional-expression 


$ THEN command 
$ command 


$ ELSE command 
~ $ command 


$ ENDIF 


* The conditional-expression can consist of one or more numeric constants, string literals, 
symbolic names, or lexical functions separated by logical, arithmetic, or string operators. 
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Evaluation of Expressions in IF Commands 
Expressions are automatically evaluated during the execution of the command. 


¢ Character strings beginning with alphabetic characters that are not enclosed in quotation 
marks are assumed to be symbol names or lexical functions. 


— The command language interpreter tries to replace these with their current values. 


— The command interpreter does not execute an IF command when it contains an 
undefined symbol. 


Instead, it issues a warning message and executes the next command in the 
procedure. 


¢ Symbol substitution in expressions in IF commands is not iterative. Each symbol is replaced 
only once. 


¢ If you want iterative substitution, precede a symbol name with an apostrophe or an 
ampersand. 


Example 11-7 Conditional Execution 


INQUIRE NCOPY "How many copies do you want?" 


IF NCOPY .LT. 5 
THEN 


MMMM: 


WRITE SYSSOUTPUT "Your copies are printing on the office printer" 
PRINT /QUEUE=OFFICE /COPIES=’NCOPY ‘P2 

$ ELSE 
WRITE SYSSOUTPUT "Your copies are printing on the lab printer" 
PRINT /QUEUE=LAB /COPIES=’NCOPY ‘'P2 

$ ENDIF 
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GOTO Command 


The GOTO command is used to transfer control to a line that is not the next line in the command 
procedure. 


¢* Format: 
$ GOTO label-name 
¢ Control is transferred to the specified label. 


* Do not append a colon (:) to the label name in the GOTO statement. 


Example 11-8 The GOTO Statement 


S$ GOTO LUNCH ! Unconditional transfer of control. 
$ SHOW USERS ! We never execute this statement. 

$ 

$ LUNCH: 

$ SHOW DEFAULT 

$ SHOW TIME 


Output from this command procedure: 


$ @GOTO 
WORK3: [SMITH] 
18-MAY-1990 10:50:17 
$ 
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lterative Procedures 


Use the GOTO command to implement iteration, which is the repetition of a group of 
commands. 


To write iterative procedures, use a looping structure. 
¢ Be careful not to create an infinite loop. 


¢ — If you accidentally create an infinite loop, press CTRL/Y to stop the procedure. Once the 
procedure stops, enter the SET VERIFY command and reexecute the procedure to try to 
find the cause of the problem. 


Example 11-9 Using Iteration 


SA-=5 

$ COUNT = 1 

$ LOOP: 

$ COUNT = COUNT + 1 

$ A=A+1 

$ IF COUNT .LT. 5 THEN GOTO LOOP 
$ SHOW SYMBOL A 
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USING LEXICAL FUNCTIONS TO MANIPULATE DATA 


Lexical functions can be used to return information about character strings as a symbol value. 
You can then manipulate the symbol values in performing tasks. 

Lexical functions are much like DCL commands. 

¢ The information provided by a DCL command is usually returned to the terminal. 


¢ Information provided by a lexical function is returned as a symbol value, usable in a 
command procedure. 


¢ Lexical functions return integer values or character strings depending on their particular 
function. 


* Lexical functions can be used in any context in which you normally use symbols or 
expressions. 


The next few pages introduce some commonly used lexical functions. See the VMS DCL 
Dictionary for details. 
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FSCVTIME 


¢ Returns information about absolute, combination, or delta time strings. 


¢ Format: 


FSCVTIME ([input-time] [, output-time-format] [, output-time-field]) 


¢ Some of the arguments for this lexical function include: 


Output-time-format: 
ABSOLUTE The requested information should be returned in absolute time format. 
COMPARISON _ The requested information should be returned in the form 


“vyyy-mm-dd hh:mmi:ss.cc". (This is the default argument.) 


DELTA The requested information should be returned in delta format. If you specify 


delta as the output time argument, you must also provide a delta time 
specification for the input time argument. 


Output-time-field: 


DATE The date field is returned. 

DATETIME The entire date and time string is returned. (This is the default argument.) 

DAY The day field is returned. | 

HOUR The hour field is returned. 

MONTH The month field is returned. You cannot specify MONTH if you also specify 
a delta input time and a delta output time argument. 

TIME The time field is returned. 

WEEKDAY The weekday that corresponds with the input time argument is returned. You 
cannot specify WEEKDAY if you also specify a delta input time and a delta 
output time argument. 

YEAR The year field is returned. You cannot specify YEAR if you also specify a 
delta input time and a delta output time argument. 

* Example: 


$ 
$ 


$ 
$ 
$ 


$ 
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DAY = FSCVTIME ("TODAY", , "WEEKDAY") 
SHOW SYMBOL DAY 
DAY = "Thursday" 


NEXT = FSCVTIME ("TOMORROW", , "WEEKDAY" ) 


SHOW SYMBOL NEXT 
NEXT = "Friday" 
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FSTIME 

« Returns the current date and time string 

¢ Format: 
FSTIME ( ) 

¢ The returned string has the following fixed, 23-character format: 
dd-mmm-yyyy hh:mm:ss.cc 


¢ Example: 


$ NOW = FSTIME() 
$ 
$ SHOW SYMBOL NOW 
NOW = "13-MAY-1989 13:27:15.35" 
$ 
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FSGETSYI 


MUN UNDUMOMNM 


Invokes the $GETSYI system service to return status and identification information about 
your system or a node in your cluster. 


Format: 
FSGETSYI (item, [node] ) 


Some of the items available for this lexical function: 


CLUSTER_MEMBER “TRUE" if the node is currently in the cluster. 

NODENAME Returns the node name (string). 

NODE SWTYPE Returns the type of operating system software used by the 
specified node (string). 

NODE_SWVERS Returns the software version of the specified node (string). 

NODE_HWTYPE Type of hardware. 

Example: 


Suppose, in your startup command procedure, you want to start certain layered products 
only on certain nodes of a cluster. Use code like the following: 


$ NODE = FSGETSYI ("NODENAME") 


@SYSSSTARTUP:PROD1 STARTUP 

IF NODE .EQS. "BARNUM" THEN 
@SYSSSTARTUP :PROD2_ STARTUP 

ENDIF 

IF NODE .EQS. "LION" .OR. NODE .EOS. "BEAR" THEN 
@SYSSSTARTUP:PROD3 STARTUP 
@SYSSSTARTUP:PROD4 STARTUP 

ENDIF 


11-34 Developing Command Procedures 


SUMMARY 


* Easily read and maintained command procedures follow an organized development cycle 
that includes: 


— Design 
— Formatting 
— Commenting 
— Testing 


¢ Use terminal I/O to gather and use information typed at the terminal in a command 
procedure. | 


— Use WRITE SYS$OUTPUT to display information to the terminal screen, one line at a 
time. 


— Use TYPE SYS$INPUT to display information from several lines in the command file 
on the terminal screen. 


— Use the INQUIRE and READ command to obtain information from the user in command 
procedures. 


¢ Control the flow of command procedures by using: 
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APPENDIX — ADVANCED DCL TOPICS 
FILE I/O 


The basic steps in reading and writing files from a command procedure are: 
1. Use the OPEN command to open the file. 
2. Use the READ or WRITE commands to read or write records. 
a. Read a record 
b. Perform some task on the record 
c. Write the record, then read a new record until the end of the file 
3. Use the CLOSE command to close the file. 


¢ Unless you explicitly close the file, it remains open until you log out. 


Figure 11-2 File I/O 



















Close the file 


ZKO-055--000056-12-PSA 
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Opening a File 


The OPEN command: 


Assigns a logical name to the file and specifies whether the file is to be read, written, or 
both. 


Can be used to open a file for read access, for write access, or both. 
Format: 
$ OPEN[/qualifier(s)] logical-name[:] _ file-specification 


The file-specification should always be the complete form so the user need not be in the 
directory when running the command procedure. 


Use qualifiers to specify the type of access you desire. 


Table 11-11 Qualifiers for the OPEN Command 
Qualifier Description 


/APPEND Opens an existing file and adds records to the end of that file. 


Cannot be used with the /WRITE qualifier. 


/ERROR=label If an error occurs when opening the file, control is transferred to the 


specified label. 


/READ Opens an existing file for reading records. (This is the default.) 


The file must exist. 


WRITE Opens a file for writing records. 


Creates a new version of the file if the /READ qualifier is not used. 
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Closing a File 
The CLOSE command closes a file and deassigns the associated logical name. 
¢ Format: 


$ CLOSE[/qualifier(s)] logical-name[:] 


Table 11-12 Qualifiers for the CLOSE Command 
Qualifier Description 


/ERROR=label lf an error occurs when attempting to close the file, control is transferred 
to the specified label. 


/[NO]LOG Generates a warning message when you attempt to close a file that was 
not opened by DCL. (/LOG is the default.) 


Example 11-10 Opening and Closing a File 


@ $ oOPEN/WRITE OUTPUT FILEX.DAT 
$ COUNT = 0 
WRITE LOOP: 
COUNT = COUNT + 1 
WRITE OUTPUT "Count is ’’COUNT’" 


$ 
$ 
$ 
$ IF COUNT .EQ. 10 THEN GOTO ENDIT 


GOTO WRITE LOOP 
ENDIT: 

CLOSE OUTPUT 

EXIT 


mmm Mm 


Notes on Example 11-10: 


@ Open the file called FILEX.DAT for write access. Assign the logical name OUTPUT to the 
file. If an error occurs in opening the file, control is transferred to the label ERROR_OPEN. 


@ Close the file, specifying the logical name, not the file specification. Closing a file deassigns 
the logical name that was created with the OPEN statement. 
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Reading from a File 


The READ command reads a single record from the specified input file and assigns the record’s 
contents to a specified symbol name. 


¢ Format: 


$ READ[/qualifier(s)] logical-name[:] symbol-name 


Table 11-13 Some Qualifiers for the READ Command 


Qualifier Description 
/END_OF_FILE=label This qualifier is used within the context of a loop where control is 


transferred to the specified label after the last record is read. 


/ERROR=label If an error occurs in reading the file, control is transferred to the 
specified label. 


Example 11-11 The READ Command 


@s open /ERROR=ERROR_OPEN/READ INFILE SAMPLE.DAT 
$ READ LOOP: 


@s READ/END_OF FILE=ENDIT INFILE RECORD 
$ GOTO READ LOOP 

© s ENDIT: 
$ CLOSE INFILE 
$ EXIT 


@ s ERROR_OPEN: 


Notes on Example 11-11: 
@ Open the file for read access. 


@ Read a record from the file. If the end-of-file is encountered, control is transferred to the 
label ENDIT. 


© Close the opened file. 


@ Go to this label if an error is encountered while trying to open the file. 
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Writing to a File 


The WRITE command writes the specified data as one record to an open file specified by a 
logical name. 


° Format: 


$ WRITE[/qualifier(s)] logical-name[:] expression 


Table 11-14 Some Qualifiers for the WRITE Command 


Qualifier Description 

/ERROR=label lf an error occurs during a write operation, control is transferred to the 
specified label. 

/SYMBOL Causes the value of a symbol to be written. 

/UPDATE Replaces the last record read with the record specified in the expression 


parameter of this WRITE command. 
(You must be able to read and write to a file to use this qualifier.) 
Example 11-12 The WRITE Command 


@ s OPEN/WRITE OUT DATA.NEW 
$ WRITE LOOP: 


Os INQUIRE DATA 

$ IF DATA .EQS. "END" THEN GOTO QUIT 
Os WRITE/SYMBOL OUT DATA 

$ GOTO WRITE _LOOP 

iS 

$ QUIT: 

$ CLOSE OUT 

$ EXIT 

$ 


Notes on Example 11-12: 

@ Open the file for write access. 

@ Solicit input (DATA) from the terminal. 

© Write the contents of the symbol DATA to the file. 
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More Uses for System-Created Logical Names 


Earlier, we talked about using SYSBOUTPUT and SYS$INPUT to send and receive information 
in command procedures. In this section, we are going to talk about redefining these two system 
logical names to redirect input and output. 


Redefining SYSSINPUT 


You can redefine SYS$INPUT to allow a command procedure to read input from the 

terminal or another file. Normally, the system reads input only from the command file itself; 
but by redefining it, you can force the system to read instructions from another file or from the 
terminal. 


For example, to edit a file from a command procedure, include the following lines in the 
command procedure: 


$ ASSIGN/USER_MODE SYSSCOMMAND SYSSINPUT 
$ EDIT MYFILE.DAT 


¢ Editors obtain input from SYS$INPUT, which is the command procedure in this case. 
¢ SYS$COMMAND refers to the terminal, the initial input stream when you logged in. 


* The /USER_MODE qualifier tells the command procedure that SYS$INPUT is 
redefined only for the duration of the next image (the editor). 


« You can perform edits interactively, then EXIT the editor. 


« When the editor image exits, SYS$INPUT resumes its default value, the command 
procedure file. 
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Redefining SYSSOUTPUT 


Normally, when you issue a command that results in output, (the DIRECTORY command for 
example), the results are displayed on your screen. When you issue such a command in a 
command procedure, the default for SYS$OUTPUT remains the screen. 


However, you might want to capture that output to do something with it. Do a directory and then 
edit the information into a report, for example. To do this, you have to redefine SYS$OUTPUT 
so the results of the command go to a file instead of the screen. 


In the following example, the display produced by SHOW DEVICES is directed to 
MYFILE.LIS in your default directory rather than to your terminal: 


$ ASSIGN/USER_MODE MYFILE.LIS SYSSOUTPUT 
$ SHOW DEVICES 


* The /USER_MODE qualifier tells the command procedure that SYS$OUTPUT is redefined 
Only for the duration of the next command. 


* Once the image exits, SYS$OUTPUT resumes its default value. 
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FLOW OF CONTROL 
CALL Command 


¢ The CALL command transfers control to a labeled subroutine within a command procedure. 
« Format: 

$ CALL label [p1 p2... p8] 
¢ label indicates the beginning of the subroutine. 


* 1 through p8 are parameters that can be passed to the subroutine. 


SUBROUTINE and ENDSUBROUTINE Commands 


« The SUBROUTINE and ENDSUBROUTINE commands define the beginning and end of 
the subroutine. 


« The SUBROUTINE command must be the first executable statement in a subroutine. 


* The ENDSUBROUTINE command functions as an EXIT command, if no EXIT command is 
specified in the procedure. 


Example 11-13 Using the CALL Command 


$ CALL DO_WORK 1 3 
$! 

$ WRITE SYSSOUTPUT ‘SUM’ 
$! 

S$ EXIT: 

$ EXIT 

$t 

$ DO WORK: SUBROUTINE 
$! 

S$ SUM == Pl + P2 

S$ EXIT 

$ ENDSUBROUTINE 
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GOSUB Command 


The GOSUB command transfers control to a labeled subroutine in a command procedure 
without creating a new procedure level. 


¢ Format: 
$ GOSUB label 
¢ label indicates the beginning of the subroutine code. 
¢ The GOSUB command does not cause the creation of a new procedure level. 


« The RETURN command terminates the GOSUB subroutine procedure, returning control to 
the command following the calling GOSUB statement. 
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Example 11-14 Using CALL and GOSUB 


2600 O00 OS 


MMM DM 


A 


A.COM 


A 
B 


5 
5 


CALL ADD AB 
SHOW SYMBOL C 
EXIT 


D: SUBROUTINE 
Pl + P2 


D 
Cc 
EXIT 
ENDSUBROUTINE 


Notes on Example 11-14: 


A.COM 


The 
and 


block of code between SUBROUTINE 
ENDSUBROUTINE is never 


accidentally executed. 


oO 
2) 


Assign the symbol A the value of 5 
Assign the symbol B the value of 5 


Call a subroutine and pass P1 and P2 
values to it 


The subroutine creates a new 
command level 


Create a global symbol that adds P1 
and P2 


Exit (Stores a value in $STATUS) 
Mark the end of the subroutine 


The value of C has been successfully 
passed back up a command level 
because C was defined as a global 
symbol 


Exit A.COM 


GOO C86 OS 


yp 


HuurunrunuVuwne 


B.COM 


5 


A 
B 5 


~ 


GOSUB ADD 
SHOW SYMBOL C 
EXIT 


ie 

aS 
ow) 

Hoo 

Gq 

w 

Za 


A+B 


B.COM 


The subroutine can be executed accidentally 
(protected by EXIT or GOTO.) 


Assign the symbol A with the value of 5 
Assign the symbol B with the value of 5 
Go to the label ADD 


Because GOSUB was used, no new 
command level was created and no 
parameters are necessary 


Create the local symbol C by adding A and 
B 


Return to the next command after the 
GOSUB command 


The value of the symbol C is successfully 
shown because GOSUB does not create 
a new command level so the local symbol 
create in ADD: is available 


Exit B.COM 
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Error Handling 


There are two basic ways to handle errors: 


, Reactive 


— Accept the system default action. 


— Specify your own action using the value of $STATUS. 


¢ Preventive 


— Override the default error handling using one of the following: 


ON WARNING (Catches WARNING, ERROR, SEVERE) 
ON ERROR (Catches ERROR, SEVERE) 

ON SEVERE (Catches SEVERE) 

SET NOON 


Specify your own action using $STATUS 


— Qualifiers in file I/O statements 


/END 
/ERROR 


— Handle interrupts using one of the following: 


ON CONTROL_Y 
SET [NO]JCONTROL=Y 
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Status Check 

During the execution of a command procedure, the command interpreter checks the condition 
code returned from each command or program that executes. The condition code can be 
generated by the system or supplied by the user in the EXIT or RETURN command. 

* The system places condition codes in the global symbol $STATUS. 

- The severity of the condition code is represented in the three low-order bits of SSTATUS. 


¢ This severity level is also represented by the global symbol $SEVERITY. 


Figure 11-3. The Global Symbols $SEVERITY and $STATUS 


31 28 27 16 15 03 02 00 


CONTROL FACILITY NUMBER MESSAGE NUMBER _ 
$STATUS $SEVERITY 


GSF-RA0294-03-RGS 


- Values for $SEVERITY, their meanings and default actions: 


0 = Warning (W) —_> Continue 
1 = Success (S) —> Continue 
2 = Error (E) —> Exit 
3 = Information (1) —> Continue 
4 = Severe or fatal error (F) —> Exit 

* Example: 


$! Continue if status is S or I. Exit on status E or F. 

$! If warning increase previously defined counter, issue message 
$! and continue. 

S$ RUN TESTPROG. EXE 

S$ IF SSEVERITY .EQ. O THEN GOSUB WARNMSG 

$ GOTO REST _OF_ PROC 

$! 

$ WARNMSG: 

$ COUNTWARN = COUNTWARN + 1 

$ WRITE SYSSOUTPUT "’’countwarn’ warning(s) have occurred" 
S$ RETURN 
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ON Command 


The ON command specifies an action to be taken when an error condition is encountered in a 


command procedure. 
¢ Format: 


$ ON condition THEN command 


¢ Temporarily overrides error handling. After execution of the command default error handling 


is reset, the condition needs to be set again. 


¢ Valid only at the current command level. 


¢ The three forms of the ON command listed are mutually exclusive, since they overlap. Only 


the last command issued is valid in any sequence. 


Table 11-15 Use of the ON Command 


Severity Level of Error and Action Taken 


Command WARNING 
By default CONTINUE 
$ ON WARNING THEN command command 

$ ON ERROR THEN command CONTINUE 
$ ON SEVERE THEN command CONTINUE 
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ERROR 
EXIT 


command 


command 


CONTINUE 


SEVERE 
(FATAL) 


EXIT 


command 


command 


command 


Example 11-15 An Example of Using Error Handling — CHOICES.COM 


$! 
$! 
S$! 
S! 


MMnununnwn 


NMNUMNMAUHAUNUNNNUMNUNMNUNNMNUNUNNUN WMD 


CHOICES .COM 

This command procedure presents the user with a menu of options. 
The user can translate a logical name, find out whether a device 
exists on the system, or exit from the command procedure. 


SAVE MESSAGE = FSENVIRONMENT ("MESSAGE") 
SET MESSAGE/NOFACILITY/NOSEVERITY /NOIDENTIFICATION/NOTEXT 


PRESENT MENU: 
TYPE SYSSINPUT 


Your options are: 


TRANSLATE Translate a logical name. 
CHECK DEV See if a device exists on the system. 
END Exit from the procedure. 


INQUIRE CHOICE “Enter your option" 


ON WARNING THEN GOTO ERROR MESSAGE 
GOTO ’CHOICE’ 


TRANSLATE: 
‘ON ERROR THEN GOTO END 
@COMPROCSNEST : TRANSLATE 
GOTO PRESENT MENU 


CHECK DEV: 
ON ERROR THEN GOTO END 
@COMPROCSNEST : CHECK_DEV 


GOTO PRESENT MENU 


ERROR MESSAGE: 
WRITE SYSSOUTPUT " " 
WRITE SYSSOUTPUT "Invalid option - please try again" 
GOTO PRESENT MENU 


END: 
SET MESSAGE ’ SAVE MESSAGE’ 
EXIT 


Notes on Example 11-15: 


Use a symbol name, rather than specifying a particular label. 


Invoke another command procedure if this option is chosen, then go back and refresh the 


menu. 


Print an error message if the user enters an invalid choice, then go back and refresh the 


menu. 
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SET NOON Command 
The SET NOON command disables any error checking performed by the system. 


* The command interpreter continues to place the status code value in $STATUS and the 
severity level in $SEVERITY, but does not perform any action based on these values. 


¢ Valid at the current command level only. 


¢ Default error handling, or the error handling created by a previous ON command, is restored 
after EXIT or SET ON. 


¢ Format: 


$ SET [NOJON 


Example 11-16 Using the SET NOON Command 


$! temporarily disable error check in LOGIN.COM so that 

$! if the process name is already set, I don’t see an error message 
$ SET NOON 

$ SET PROCESS/NAME="may be duplicate" 

$ SET ON 
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ON CONTROL_Y Interrupts 
Use the ON command to handle CTRL/Y interrupts. 
¢ Format: 
$ ON CONTROL_Y THEN command 
¢ $0ON CONTROL_Y remains in effect until: 
— Itis changed with another CONTROL_Y command 
— Overruled by SET NOCONTROL=Y command 
— Exit of current command level 


« When CTRL/Y is pressed, the current command is aborted and control passes to the 
specified routine. 


¢ Example: 


$ ON CONTROL _Y THEN GOTO Y_TRAP 
$ ON CONTROL _Y THEN LOGOUT 


SET NOCONTROL=Y 


* Disables CONTROL/Y at all command levels. 
* Use with caution. 
¢ Format: 


$ SET [NO]JCONTROL=Y 
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Handling File I/O Errors 


Use the /ERROR qualifier with the OPEN, READ/END, WRITE, and CLOSE commands to 
handle errors encountered while working with files. 


* Control is passed to the specified label. 


- System error message is not displayed. 


Example 11-17 Handling File I/O Errors 


$ START: 
$ OPEN/READ/ERROR=NO_FILE CALLS LOGFILES:CALL.LOG 
$ 
$ READ LOOP: 
Qs READ/END=DONE CALLS DATA_LINE 
$ WRITE SYSSOUTPUT DATA _LINE 
$ GOTO READ LOOP 
$! 
© s no FILE: 
$ WRITE SYSSOUTPUT "Call log doesn’t exist." 
$ EXIT 
$ 
Os Done: 
$ CLOSE CALLS 
$ EXIT 


Notes on Example 11-17: 


@ Attempt to open the file, assuming that it exists. If it does not exist, transfer control to the 
label NO_FILE. 


@ Read a record from the CALLS file. If the end of the file is encountered, transfer control to 
the label DONE. 


© The command procedure labled NO_FILE displays a message, and exits. Control is 
transferred to this label when the OPEN command finds that the file CALLS doesn’t exist. 
Display a message and exit. 


@ When the enc-of-file is encountered, control transfers to this label; close the file, and exit. 
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USING SYMBOLS 


Accessing Local and Global Symbol Tables 


As you start to use symbols more in command procedures, you will need to understand the 
difference between local and global symbols in greater detail. 


Command Levels 


When you log in to a VMS system, you are at what is called DCL command level. Whenever 
you run a command procedure, you create another command level. If the command procedure 
that you run, in turn, runs another command procedure, it creates yet another command level. 


This structure is not unlike an outline: 
DCL command level 
First command procedure command level 


Second command procedure command level 


You can create up to 32 of these levels. 


When you use symbols in command procedures, it is important to understand these levels and 
how local and global symbols work so you can pass information from one level to another using 
symbols. | 
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Local Symbols 


¢ Are available to: 
— The command level that defined them 
— Lower command levels 
¢ Last for the duration of the current command level 
« Are created with a single equal sign (=) 
$ PRINT = "PRINT/NOTIFY" 
« Are deleted using the following command: 
$ DELETE/SYMBOL/LOCAL PRINT 


(The /Locat qualifier is optional, since /Locat is the default.) 


Global Symbols 


¢ Are available to all command levels 
« Allow you to pass information between command levels 
« Are created with a double equal sign (== 
$ PRINT == "PRINT/NOTIFY" 
¢ Last for the duration of the process 
¢ Are deleted using the following command: 


$ DELETE/SYMBOL/GLOBAL PRINT 
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Figure 11-4 Accessing Local and Global Symbol Tables 


DCL COMMAND PROMPT 


@ 51-0 

© $c-="demo" 
© s@acom 
@ $SHOWSyYMBOLL 






@ ssHowsyms0.G 


Notes on Figure 11-4: 


@ Create a local 
numeric symbol, 
L, at DCL level 0 


@ Create a global 
string symbol, G, 
at DCL level 0 


© Execute a 
command 
procedure, 
A.COM 


® The symbol L 
equals (0) 


@® The symbol G 
equals "demo" 


A.COM 








© s1--1 
5) $ @B.COM 


@ $SHOWsyYMBOL G 


@ sexi 


Create a local 
numeric symbol, 
L, at level -1 


Invoke another 
command 
procedure, 
B.COM 


The symbol G 
equals "demo" 


Return 
command to 
the previous 
level 


B.COM 











© $ SHOW SYMBOL L 


@ $ SHOW SYMBOL G 


@ $1--2 


© s$sHowsymsoit 


@ sexi 


GSF-RA0294-01-RGS 


The symbol L equals (-1) 
The symbol G equals "demo" 


Create a local symbol, L, at this new 
level -2 


The symbol L equals (-2) 


Return control to the previous level 
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Phases of Command Processing 
The command interpreter performs symbol substitution in three phases: 
1. Command Input Scanning 


a. The command interpreter evaluates symbols preceded by apostrophes 
from left to right. 


b. The command interpreter inserts a null string if a value for the symbol is not found. 


2. Command Parsing 


a. The command interpreter analyzes the command line and checks the form, function, 
and syntactical relationship of each part. 


b. Command synonyms are evaluated. 
c. Symbols preceded by an ampersand (&) are evaluated from left to right. 


d. The command interpreter inserts a null string if a symbol is not found. 


3. Expression Evaluation 
Replaces symbols not translated until execution time. 


a. 
b. Evaluates symbols preceded by the IF and WRITE commands. 


9 


Evaluates symbols within lexical functions. 


d. lf the symbol is not defined, the command interpreter displays a warning message and 
stops processing. 
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Using Symbols to Format Output 


Now that you have performed some task on a character string, you want to be able to write the 
new character string out to a file or record. 


Creating Character String Symbols 


You have already created character string symbols by using an equal sign and then enclosing 
the character string in quotes: 


$ X = "THIS IS A SYMBOL" 


When using symbol overlays to format data, you need to use a different assignment format. 
You use: 


‘= To create a local character string symbol 


:== To create a global character string symbol 


When creating a symbol with the := or the :==, you do not enclose the character string in 
quotation marks. The colon-equals tells the VMS operating system that what follows is a 
character string value. 


Example 11-18 Comparing Symbol Creation Methods 


Os X := Richard Mendes 
$ SHOW SYMBOL X 
X = “RICHARD MENDES" 


S$ Y :== Richard Mendes 
SHOW SYMBOL Y 
Y = "RICHARD MENDES" 


$ 
e 
$ 


$ Z = "Richard Mendes" 
SHOW SYMBOL Z 
Z2 = "Richard Mendes" 


$ 
© 
$ 


Notes on Example 11-18: 
@ Create a local character string symbol. Translation is converted to all uppercase. 
@ Create a global character string symbol. Translation is converted to all uppercase. 


© Create a literal character string symbol. Case is preserved. 
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String Overlays 


¢« The format for performing a substring overlay is: 


$ symbol-name[offset, size] := replacement string 
(or) 
$ symbol-name[offset,size] :== replacement-string 


— Offset is an integer that indicates the position of the replacement string relative to the 
first character in the original string. 


— Size is an integer that indicates the length of the replacement string. 
¢ String overlays can be used to create output records with aligned columns. 


— The following example does not provide column alignment: 


$ NAME := Andrea Vassilos 
S$ PHONE := 888-8888 

$ WRITE SYSSOUTPUT NAME, PHONE 
ANDREA VASSILOS888-8888 


— The following example illustrates how a substring overlay can achieve aligned columns: 


$ RECORD[{0,20] := ’NAME’ 

$ RECORD[23,11] := ‘PHONE’ 

$ WRITE SYSSOUTPUT RECORD 
ANDREA VASSILOS 888-8888 


¢ — If you simply wish to create a blank line, the following overlay example could be used: 
$ BLANK_LINE[0,80] := "" 
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Arithmetic Overlays 


A special form of the assignment statement can be used to perform binary overlays of the 
current symbol value. 


¢ The format is: 


$ symbol-name[bit-position,size] = replacement-expression 
$ symbol-name[bit-position,size] == replacement-expression 


— Bit-position is an integer that indicates the location relative to bit 0, where the overlay 
is to occur. 


— Size is an integer that indicates the number of bits to be overlaid. 
¢ May be used to equate a symbol to ring the bell. 
— The bell is generated by CTRL/G, which has the numeric value of %X07. 


— The following example shows how this would be achieved: 


Example 11-19 Ringing the Bell from Inside a Command Procedure 


@s$ BELL[0,32] = %x07 
@ 5 WRITE SYSSOUTPUT BELL 


Notes on Example 11-19: 
@ The maximum length for bit and size is 32. We are overlaying the entire value. 


CTRL/G has a numeric value of %X07. We are associating the value for CTRL/G with the 
symbol BELL. 


@ Remember that we discussed that the WRITE could be followed by a symbol. Here we 


are using the symbol BELL to write the value of CTRL/G to SYS$OUTPUT, which is the 
terminal screen by default. The result is, the bell rings. 
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LEXICAL FUNCTIONS 


Process Information Lexical Functions 


Process information lexical functions are used to obtain data about processes. They allow you 
to save and restore the characteristics of your process. 


FSDIRECTORY 
¢ Returns the current default directory as a character string 


* Does not return the associated device 


e Format: 
FSDIRECTORY ( ) 
* Example: 


$ SHOW DEFAULT 
USER_DISK: [FRED.SUB1] 


$ 

$ CURR_DIR = FSDIRECTORY () 

$ SHOW SYMBOL CURR_DIR 
CURR_DIR = "[FRED.SUB1]" 


SET DEFAULT SYS$LOGIN 
SHOW DEFAULT 
USER_DISK: [FRED] 


MUNN 


SET DEFAULT ’CURR_DIR’ 
SHOW DEFAULT 
USER_DISK: [FRED.SUB1] 


mun 
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FSENVIRONMENT 


Returns information about the DCL command environment 


Format: 
FSENVIRONMENT (item) 


Some of the items you can supply to this lexical function: 


DEFAULT Returns the default device and directory name. This information is 
returned as a character string. The returned string is the same as the 
output from a SHOW DEFAULT command. 


KEY_STATE Returns a character string indicating the current locked keypad state. 


MESSAGE Returns a character string containing the current setting of the SET 
MESSAGE command. 


PROCEDURE _ Returns the file specification for the command procedure from which 
the FSENVIRONMENT("PROCEDURE") function is issued. The file 
specification is returned as a character string. If the lexical function is 
invoked interactively, a null string ("") is returned. 


PROMPT Returns a character string containing the current prompt string. 


PROTECTION _ Returns a character string indicating the current default file protection. 
The string is in a form that can be used with the command 
SET PROTECTION/DEFAULT to form a valid DCL command line. 


Example: 


$ CURR_MSG = FSENVIRONMENT ("MESSAGE") 
$ SHOW SYMBOL CURR_MSG 
CURR_MSG = "/FACILITY/SEVERITY/IDENTIFICATION/TEXT" 


SET MESSAGE/NOIDENTIFICATION/NOTEXT 


CURR_MSG = FSENVIRONMENT ("MESSAGE") 

SHOW SYMBOL CURR MSG 

CURR_MSG = "/FACILITY/SEVERITY/NOIDENTIFICATION/NOTEXT" 
$ 


$ 
$ 
$ 
$ 
$ 
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FSGETJPI 


¢ Invokes the $GETJPI system service to return process information about the specified 
process. 


¢ Format: 
FSGETJPI (process-id, item) 


¢ Some of the items you can supply to this lexical function: 


ACCOUNT Returns the account name containing eight characters with trailing 
blanks 

FILLM Returns the open file quota (as an integer) 

JOBPRCCNT Returns the number of subprocesses owned (integer) 

PID Returns the process identification number (string) 

PRCLM Returns the subprocess quota (integer) 

PRCNAM Returns the process name (string) 

TERMINAL Returns the login terminal name for interactive users (string) 

UIC Returns the process’s UIC (string) 

USERNAME Returns the user name string (12 characters filled with trailing 
spaces) 

WSSIZE Returns the process’s current working set size (integer) 

* Example: 
$ USER = FSGETJPI("","USERNAME") 


S$ SHOW SYMBOL USER 
USER = "SMITH ” 
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F$MODE 


INTERACTIVE, NETWORK, 
Format: 
EF SMODE ( ) 


Example: 


S$ MODE = FSMODE() 

$ SHOW SYMBOL MODE 
MODE "INTERACTIVE" 

$ 


F$PRIVILEGE 


in the specified list. 
Format: 
FSPRIVILEGE (priv-list) 


Example: 


PRIV 
SHOW 
PRIV 


SYMBOL PRIV 
"FALSE" 


PRIV 
SHOW 
PRIV 


SYMBOL PRIV 
= "TRUE" 


SHOW PROCESS/PRIVILEGE 


17-MAY-1990 10:38:58.45 


Process privileges: 


Returns a character string indicating the mode in which a process is running (for example, 


BATCH, or OTHER). 


Returns the value of TRUE or FALSE depending on whether your process has a privilege 


FSPRIVILEGE ("BYPASS") 


FSPRIVILEGE ("TMPMBX") 


SMITH 
WHYNOT 


User: 
Node: 


202001C4 
"SMITH" 


Process ID: 
Process name: 


create temporary mailbox 
create network device 


TMPMBX may 
NETMBX may 
Process rights identifiers: 

INTERACTIVE 

REMOTE 

SYSSNODE_WHYNOT 
$ 
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F$PROCESS 
« Returns the current process name. 
° Format: 

FSPROCESS ( ) 


* Example: 


$ PROC_NAME = FSPROCESS () 
$ SHOW SYMBOL PROC_NAME 

PROC_NAME = "John Smith" 
$ 


FSSETPRV 
* Invokes $SETPRV system service to enable or disable specified user privileges. 
¢ Your process must be authorized to set the specified privilege. 
* Format: 
FSSETPRV (priv-states) 


¢« Example: 


$ OLDPRIV = FSSETPRV ("OPER, NOTMPMBX" ) 
$ SHOW SYMBOL OLDPRIV 


OLDPRIV = "NOOPER, TMPMBX" 
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FSUSER 


Returns the current user identification code (UIC) in alphanumeric format. 
Format: 
FSUSER () 


Example: 


$ UIC = FSUSER() 
$ SHOW SYMBOL UIC 

UIC = "[GROUP11,SMITH]" 
$ 


FSVERIFY 


Returns an integer value indicating whether the procedure verification setting is currently 
on or off. 


lf used with arguments, FSVERIFY can turn the procedure and image verification settings 
on or off. 


You must include the parentheses after the F$VERIFY function whether or not you specify 
arguments. 


Format: 
FSVERIFY ([procedure-value] [, image-value] ) 
Example: 


$ SAVE _PROC_VERIFY = FSENVIRONMENT ("VERIFY PROCEDURE") 
S SAVE_IMAGE VERIFY = FSENVIRONMENT ("VERIFY IMAGE") 
$ SET NOVERIFY 


$ TEMP = FSVERIFY (SAVE PROC VERIFY, SAVE IMAGE VERIFY) 
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System Information Lexical Functions 


System information lexical functions allow the user to obtain information about system 
parameters such as: 


« System message text 
¢ Physical devices 
¢ Logical names and their attributes 


¢ Date and time 
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FSGETDVI 


Invokes the $GETDVI system service to return information about a physical device. 
Format: 

FSGETDVI (device-name, item) 
device-name can be either a physical or logical name. 


Some of the items available for this lexical function: 


DEVCLASS Number representing device class (disk, tape, etc.) 
DEVTYPE Number representing specific device type 
ERRCNT Number of errors logged on the device 
EXISTS "TRUE" if a device with that name exists 
FREEBLOCKS Number of free blocks on a disk volume 
MNT "TRUE" if device is mounted 
Example: 
$ MOUNTED = FSGETDVI ("WORK12:", "MNT") 
$ SH SYM MOUNTED 

MOUNTED = "TRUE" 


$ 
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FSMESSAGE 
« Returns the message text associated with a specific system status code 
¢ Format: 

FSMESSAGE (status-—-code) 


¢ Example: 


$ RUBBISH 
%DCL-W-IVVERB, unrecognized command verb --- check validity and spelling 
\RUBBISH\ 


$ SHOW SYMBOL $STATUS 
SSTATUS = "%X00038090" 


$ 
S$ ERROR = FSMESSAGE ($STATUS) 
$ SHOW SYMBOL ERROR 

ERROR = "SCLI-W-IVVERB, unrecognized command verb --- check validity and 
spelling" 
$ 


FSTIME 
« Returns the current date and time string 
¢ Format: 
FSTIME () 
¢« The returned string has the following fixed, 23-character format: 


dd-mmm-yyyy hh:mm:ss.cc 


¢ Example: 


$ NOW = FSTIME() 
$ 
$ SHOW SYMBOL NOW 
NOW = "13-MAY-1989 13:27:15.35" 
$ 
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FSTRNLNM 


Returns the equivalence string or requested attributes associated with the logical name. 


Does not perform iterative translation. 


Format: 


FSTRNLNM (logical-name[,table] [, index] [,mode] [, case] [, item] ) 


Some of the values you can supply for the item argument: 


CONCEALED 


CONFINE 


TABLE 


TABLE_NAME 
TERMINAL 


VALUE 


Example: 


Returns one of the character strings "TRUE" or "FALSE" to 
indicate whether the CONCEALED attribute was specified with the 
/TRANSLATION_ATTRIBUTES qualifier when the logical name was 
created. The CONCEALED attribute is used to create a concealed 
logical name. 


Returns one of the character strings "TRUE" or "FALSE" to indicate 
whether the logical name is confined. If the logical name is 
confined (true), then the name is not copied to subprocesses. If 
the logical name is not confined (false), then the name is copied to 
subprocesses. 


Returns one of the character strings “TRUE” or "FALSE" to indicate 
whether the logical name is the name of a logical name table. 


Returns the name of the table where the logical name was found. 


Returns one of the character strings "TRUE" or "FALSE" to indicate 
whether the TERMINAL attribute was specified with the 
/TRANSLATION_ATTRIBUTES qualifier when the logical name was 
created. 


Returns the equivalence name associated with the specified logical 
name. If the logical name has more than one equivalence name, 
the FSTRNLNM function returns the name specified by the index 
argument. VALUE is the default if you do not specify an item 
argument. 


$ ASSIGN/TRANSLATION ATTRIBUTES=TERMINAL TESTDATA.COM TEST 


§ 
$ SHOW LOGICAL/FULL TEST 


"TEST" [super] 


= "TESTDATA.COM" [terminal] (LNMSPROCESS TABLE) 


$ 
$ X = FSTRNLNM("TEST",,,,, TERMINAL") 
$ 
$ SHOW SYMBOL X 
X = "TRUE" 


$ 
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Character Manipulation Lexical Functions 


Character manipulation lexical functions allow you to obtain and operate on character strings. 
Some of the operations you can do are: 


¢« Return character strings to you in a specified format 

¢« Extract specific parts of a character string 

e Edit a string that is returned to you 

* Convert character and numeric input to character strings 
¢« Return the integer equivalent of a specified string 

¢ Return the length of a string 


¢« Locate a substring within a string and return the offset position 
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FSEDIT 
- Edits a string expression 
¢ Format: 
FSEDIT (string, edit-list) 


« Values you can supply for the edit-list argument: 
COLLAPSE Removes ail spaces and tabs from the string 
COMPRESS Replaces multiple spaces and tabs with a single space 
LOWERCASE Makes the string lowercase 
TRIM Removes leading and trailing spaces and tabs from the string 
UNCOMMENT Removes comments from the string 


UPCASE Makes the string uppercase 
¢ Example: 
$ LONG = " this symbol is in LowerCaSe and has some spaces in it " 


$ SHORT = FSEDIT (LONG, "COMPRESS, UPCASE") 
$ SHOW SYMBOL SHORT 

SHORT = " THIS SYMBOL IS IN LOWERCASE AND HAS SOME SPACES IN IT " 
$ 
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FSEXTRACT 
- Extracts a substring from a character string expression. 
¢ Format: 

FSEXTRACT (offset, length, string) 


* Example: 
$ FULL_NAME = "FRED BLOGGS" 
S FIRST_NAME = FSEXTRACT(0,4,FULL_NAME) 
$ SHOW SYMBOL FIRST NAME 


FIRST NAME = "FRED" 
$ 


F$FAO 


¢ Converts character and numeric input to character strings. (FAO stands for Formatted 
ASCII Output). 


« Format: 


FSFAO(control string[,argl,arg2...arg15]) 


¢ Example: 
s A = "ERR" 
$ B= "Is" 
$ C = "HUMAN" 


$ PHRASE = FSFAO("TO !#(#AS)", 3, 6, A, B, C)} 
$ SHOW SYMBOL PHRASE 
PHRASE = "TO ERR Is HUMAN " 
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FSINTEGER 
« Returns an integer equivalent of the specified string. 
¢ Format: 

FSINTEGER (string) 


« Example: 


$ A = FSINTEGER ("TRUE") 
$ SHOW SYMBOL A 


A=1 Hex = 00000001 Octal 00000000001 


$ 
$ A = FSINTEGER ("FALSE") 
$ SHOW SYMBOL A 

A= 0 Hex = 00000000 Octal = 00000000000 
$ 


FSLENGTH 
¢ Returns the length of a string. 
¢ Format: 

FSLENGTH (string) 


* Example: 


$ LEN = FSLENGTH ("HOW LONG IS THIS STRING?") 
$ SHOW SYMBOL LEN 

LEN = 24 Hex = 00000018 Octal = 00000000030 
$ 
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FSLOCATE 
*  Locates the substring in the string and returns the offset position. 
¢ Format: 

FSLOCATE (substring, string) 


¢ Example: 


$ LONG STRING = "This is a long string. We are looking for the word ’long’" 
$ FIND = FSLOCATE("long",LONG STRING) 

$ SHOW SYMBOL FIND 

FIND = 10 Hex = QOQOO0000A Octal = 00000000012 

$ , 
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File Information Lexical Functions 

File information lexical functions allow you to: 

¢ Return attribute information for a specific file, in integer or character form 
¢ Parse a file specification and return the whole or any part of it 


* Search a directory file and return a file specification 
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FSFILE_ATTRIBUTES 


Returns attribute information for a specific file, in integer or character string form, depending 
upon the item you request. 


Format: 
FSFILE ATTRIBUTES (file-spec, item) 


Some of the values you can supply for item: 


ALQ Allocation quantity (as an integer) 
BDT Backup date/time string 
CDT Creation date/time string 
CTG True, if contiguous 
Returns the value "TRUE" or "FALSE" 
EDT Expiration date/time string 
EOF Number of blocks used (integer) 
FID File ID string 
KNOWN Known file 


Returns the value "TRUE" or "FALSE" to indicate whether file is installed 
with the Install utility 


ORG File organization 

Returns the value "SEQ", "REL", or "IDX" 
PRO _ File protection string 
UIC Owner UIC string 


$ DIRECTORY/PROTECTION/OWNER 
Directory SYS$SYSDEVICE: [SMITH] 


TEST.COM; 5 {SMITH] (RWED, RWED, RE, ) 
TEST.DIR;1 [SMITH] (RWE , RWE, RE, E) 


Total of 2 files. 
$ 


$ PROT = FSFILE ATTRIBUTES ("TEST .COM", "PRO") 
$ SHOW SYMBOL PROT 
PROT = "SYSTEM=RWED, OWNER=RWED, GROUP=RE, WORLD" 


$ 
$ OWNER = FSFILE ATTRIBUTES ("TEST.COM", "UIC") 
$ SHOW SYMBOL OWNER 

OWNER = "[SMITH]" 
$ 
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FSPARSE 


Invokes the $PARSE RMS routine to parse a file specification and to return either the 
expanded file specification or the particular file specification field you request. 


Format: 


FSPARSE (file-spec[,default-spec] [, related-spec] [, field] [,parse-type] ) 


Values you can supply for the field argument: 
NODE 
DEVICE 
DIRECTORY 
NAME 

TYPE 
VERSION 


Node name 

Device name 
Directory name 

File name 

File type 

File version number 


Values you can supply for the parse-type argument: 
NO_CONCEAL 


SYNTAX_ONLY 


Example: 


$ 
$ 


$ 
$ 
$ 


$ 


FULL FILE SPEC = 


Logical names are not concealed. 
Therefore, logical name translation does not end when a 
concealed logical name is encountered. 


The syntax of the file specification is checked without verifying 
that the specified directory exists on the specified device. 


F SPARSE ("TEST .COM") 


SHOW SYMBOL FULL FILE SPEC 


FULL FILE SPEC = " 


SYSSSYSDEVICE: [SMITH] TEST. COM; " 


FULL_FILE SPEC = FSPARSE ("TEST.COM",,,version, "NO CONCEAL") 
SHOW SYMBOL FULL FILE SPEC 
FULL FILE SPEC = "WHYNOTSDUAO: [SMITH] TEST.COM;" 
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FSSEARCH 


* Invokes the $SEARCH RMS routine to search a directory file and to return the full file 
specification of a file you name. 


« Format: 


FSSEARCH (file-spec[, stream-id] } 


¢ Example: 


$ 
$ 


$ 
$ 
$ 


$ 


IS IT THERE = FSSEARCH ("TEST .COM") 
SHOW SYMBOL IS_IT_ THERE 
IS IT THERE = "SYSSSYSDEVICE: [SMITH] TEST.COM;5" 


IS IT THERE = FSSEARCH ("NONEXISTENT. FILE") 
SHOW SYMBOL IS_IT THERE 
IS IT THERE = "" 


¢  Stream-id 


— The search stream identification number is used to maintain separate search contexts 


when you use the FSSEARCH function more than once and when you supply different 
file-spec arguments. 


— If you use F$SEARCH more than once in a command procedure, and if you also 


use different file-spec arguments, specify stream-id arguments to identify each search 
separately. 


— If you omit the stream-id, FESEARCH assumes an implicit single search stream. 


That is, it starts searching at the beginning of the directory file each time you specify a 
different file-spec argument. 
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Written Exercises 


QUEUE MANAGEMENT 


Written Exercise 3-1 — Queues 


1. What is the name of the system process that schedules print and batch jobs? 


2. What is the name of the system process that performs many other system management 
and control tasks? 


3. Match the type of queue with its function. 


Queue Type Action 
___ Moves jobs to specified execution queues when a. Execution 
resources for executing the job are available b. Generic 


___Prints the file or processes the batch job 
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Solutions to Written Exercise 3-1 — Queues 


1. What is the name of the process that schedules print and batch jobs? 
QUEUE_MANAGER 


2. What is the name of the system process that performs many other system management 
and control tasks? 


JOB CONTROL 


3. Match the type of queue with its function. 


Queue Type Action 
_b Moves jobs to specified execution queues when a. Execution 
resources for executing the job are available b. Generic 


_a Prints the file or processes the batch job 
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Written Exercise 3-2 — Queue Creation 


1. List the five steps taken to establish a print execution queue: 


a. 


e. 


2. Write the DCL command that you would use to display all device queues. 


3. Write the DCL command that you would use to create and start a print queue. 
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Solutions to Written Exercise 3-2 — Queue Creation 


1. List the five steps taken to establish a print execution queue: 
a. Set physical attributes of device 
b. Spool each printing device 
c. Initialize and start an execution queue for each printing device 
d. Initialize and start a generic print queue 
e. Initialize and start a generic terminal queue 
2. Write the DCL command that you would use to display all device queues. 
$ SHOW QUEUE/DEVICE 
3. Write the DCL command that you would use to create and start a print queue. 


$ INITIALIZE/QUEUE/START/ON=LPAO SYSSPRINT 
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MAINTAINING SYSTEM SECURITY 


Written Exercise 8-1 — Process Parameters 


Example 12-1 displays the characteristics of a process that has several privileges on your 
system. Using the information displayed in the example, determine the value of each of the 
following parameters: 


Answers Parameters 


Account name 

Default device and directory specification 
Interactive terminal specification 
Process identification number 
Process name 

User identification code 

User name 

Priority 

CPU limit 

Open file quota 

Working set limit 

Working set quota 


Privileges (list them) 
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Example 12-1 Process Parameters of a Sample Interactive Process 


$ SHOW PROCESS/ALL 


19-APR-1990 17:05:08.99 User: GABRIEL Process ID: 20200242 
Node: TRMPET Process name: Bugler 
Terminal: LTA28: (ZK1123/LC-4-2) 
User Identifier: [ULTIMATE, GABRIEL] 
Base priority: 4 
Default file spec: DISKSCOMPACT: [GABRIEL] 
Devices allocated: BROWNYSLTA28: 
Process Quotas: 
Account name: MUSIC 
CPU limit: Infinite Direct I/O limit: 100 
Buffered I/O byte count quota: 50000 Buffered I/O limit: 100 
Timer queue entry quota: 80 Open file quota: 50 
Paging file quota: 49978 Subprocess quota: 8 
Default page fault cluster: 64 AST quota: 100 
Enqueue quota: 600 Shared file limit: 0 
Max detached processes: O Max active jobs: 0 
Accounting information: 
Buffered I/O count: 8241 Peak working set size: 10268 
Direct I/O count: 763 Peak virtual size: 24376 
Page faults: 37681 Mounted volumes: A 
Images activated: 35 
Elapsed CPU time: 0 00:13:37.81 
Connect time: 0 01:25:13.34 
Process privileges: 
CMKRNL may change mode to kernel 
TMPMBX may create temporary mailbox 
OPER operator privilege 
NETMBX may create network device 
Process rights identifiers: 
INTERACTIVE 
LOCAL 
SYSSNODE_BROWNY 
Process Dynamic Memory Area 
Current Size (bytes) 25600 Current Total Size (pages) 
Free Space (bytes) 21744 Space in Use (bytes) 
Size of Largest Block 21712 Size of Smallest Block 
Number of Free Blocks 4 Free Blocks LEQU 32 Bytes 
Processes in this tree: 
Satchmo 
Bugler (*) 
S ; 
$ SHOW WORKING SET 
Working Set /Limit= 1024 /Quota= 4096 /Extent= 8192 


Adjustment enabled Authorized Quota= 4096 Authorized Extent= 8192 


$ 
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50 
3856 


Solutions to Written Exercise 8-1 — Process Parameters 


Answers 
MUSIC 


DISK$COMPACT GABRIEL] 
LTA28: 


20200242 


Bugler 
[ULTIMATE,GABRIEL] 


GABRIEL 
4 


Infinite 
50 


1024 


4096 


CMRKNL, TMPMBX, OPER, 


NETMBX 


Parameters 


Account name 

Default device and directory specification 
Interactive terminal specification 

Process identification number 


Process name 
User identification code 


User name 
Priority 


CPU limit 
Open file quota 


Working set limit 
Working set quota 


Privileges (list them) 
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Laboratory Exercises 


INTRODUCTION 


The exercises in this chapter are organized to practice skills taught in each chapter. You will 
find exercises pertaining to each chapter under the chapter title as a heading in this chapter. 


More importantly, the exercises in this course are designed as several exercises with many 
parts. Each chapter-associated exercise practices a particular skill or skills learned in that 
chapter. 


Each laboratory section is followed by a matching section that discusses output you may have 
seen, gives hints, or actually provides sample code that would accomplish the tasks assigned 
in the laboratory exercise. 


The solution that is included after each exercise identifies just one way to approach the exercise. 
As is always the case with any exercise, there may be several different approaches that are 
just as valid. 


The exercises all assume that you have a student account with privileges of a system manager, 
and that you have already logged in to the system. 
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LABORATORY EXERCISES — MANAGING DISKS 


Laboratory Exercise 1-1 — Devices 

Perform the following exercises at an interactive terminal. 

1. Enter the command to list devices on the system. 

2. Enter the command to list the complete status of devices on the system. 
3. Enter the command to list only disks on the system. 


4. Enter the command to list files that are currently open. 
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Solutions to Laboratory Exercise 1-1 — Devices 


1. Enter the command to list devices on the system. 
$ SHOW DEVICE 

2. Enter the command to list the complete status of devices on the system. 
$ SHOW DEVICE/FULL 

3. Enter the command to list only disks on the system. 
$ SHOW DEVICE D 

4. Enter the command to list files that are currently open. 


S$ SHOW DEVICE/FILES 
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Laboratory Exercise 1-2 — Devices 


At an interactive terminal, enter the command to produce the following information on your 
device: 


1. What type of disk is it? 

Is it mounted on the local system? 

Is it mounted on any other system in the cluster? 
How big is it? (in 512-byte blocks) 

How many blocks are free? 


What is the owner UIC and volume protection? 


ae: Oe ~OF oe <r 


Has it generated any hardware errors since the system was started up? 
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Solution to Laboratory Exercise 1-2 — Devices 


The command used to produce this disk information is: 
$ SHOW DEVICE/FULL $1$DUA0 


Here is a sample output from that command: 


$ SHOW DEVICE/FULL $1SDUA0 


Disk $1$DUA0: (BARNUM), device type RA81,@ is online, mounted, 
@£ ile-oriented device, 
shareable, served to cluster via MSCP Server, error logging is enabled. 


Error count 0@ Operations completed 5989 
Owner process me Owner UIC [1,11)8 
Owner process ID 00000000 Dev Prot S:RWED, 0: RWED,G:RWED, W: RWED@ 
Reference count al Default buffer size 512 
Total blocks 891072@ sectors per track 51 
Total cylinders 1248 Tracks per cylinder 8 
Allocation class 1 
Volume label "FLYING" Relative volume number 0 
Cluster size 3 Transaction count 93 
Free blocks 80698 Maximum files allowed 222768 
Extend quantity 5 Mount count 7 
Mount status System Cache name " $S1SDUA0: XQPCACHE" 
Extent cache size 64 Maximum blocks in extent cache 2088 
File ID cache size 64 Blocks currently in extent cache 0 
Quota cache size 30 Maximum buffers in FCP cache 129 
Volume status: subject to mount verification, file high-water marking, write- 


through caching enabled. 
Volume is also mounted on RNGLNG, BAILEY, LION, HORSE, BEAR, TIGER.© 


This output answers questions including the following, which are keyed to the example. 
What type of disk is it? 

Is it mounted on the local system? 

Is it mounted on any other system in the cluster? 

How big is it? (in 512-byte blocks) 

How many blocks are free? 


What is the owner UIC and volume protection? 


e668 6 6 8 6 


Has it generated any hardware errors since the system was started up? 
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Laboratory Exercise 1-3 — Disk Quotas 


NOTE: You cannot perform these exercises unless you have write access to the quota file on 
your class volume. Check with your instructor before you attempt the exercises. 


1. 


2. 


Log in using your own account. 
Run the SYSMAN utility (requires OPER privilege). 


Enter the DISKQUOTA SHOW/DEVICE command, specifying your class volume name, 
and display all the quota records in the quota file for the class volume. 


To observe the effects of disk quotas, perform the following: 

a. Display your current disk quota settings. Write them down. 

b. Delete your record from the quota file. 

c. Exit from the SYSMAN utility. 

d. Try to create a small text file by using either the CREATE command or a text editor. 


e. Reenter the SYSMAN utility and add a diskquota record for yourself. Specify the 
values you previously wrote down for permanent quota and overdraft. Do not forget 
to specify your class volume name with the /DEVICE qualifier. 


f. Exit from the SYSMAN utility. 


g. Enter the SHOW QUOTA command (from DCL level). Record the usage count. Create 
a small text file. 


h. Enter the SHOW QUOTA command again. Notice that your usage count has increased. 


i. Reenter the SYSMAN utility and display your diskquota record in the quota file for the 
class volume. Notice that your usage count has been increased here as well. 


Modify your record to increase your permanent quota by 1000 blocks and your overdraft by 
200 blocks. 


Exit from the SYSMAN utility. 
Set your default to SYS$SYSTEM. 


Run the SYSMAN utility again. Enter the appropriate commands to display your record in 
the quota file for the class volume. 
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Solutions to Laboratory Exercise 1-3 — Disk Quotas | 


1. No solution needed. 


2. $ RUN SYSSSYSTEM: SYSMAN 


3. SYSMAN> DISKQUOTA SHOW /DEVICE=CLASS DISK [*,*] 


Substitute the name of your class volume for CLASS_DISK. 


a. 


Enter the following commands to observe the effects of disk quotas. 


SYSMAN> DISKQUOTA SHOW [320,10] 


Substitute your UIC for [320,10]. If the utility displays the alphanumeric form of 
your UIC, substitute it for [320,10]. For example, if the string form of your UIC is 
[GRP320,SMITH], enter the following command: 


SYSMAN> DISKQUOTA SHOW [GRP320,SMITH] 
SYSMAN> DISKQUOTA DELETE [320,10] 
SYSMAN>EXIT 


Note that you are unable to create files on the volume because you do not have a disk 
quota. 


$ RUN SYSSSYSTEM: SYSMAN 
SYSMAN> DISKQUOTA ADD /DEVICE=CLASS DISK [320,10] 


Substitute the name of your class volume for CLASS_DISK and your UIC for [320,10]. 
SYSMAN>EXIT | 
$ SHOW QUOTA 


The usage count should be 0. The following is a short text file you might create. 


$ CREATE FILE.TXT 
This is a short text file. 
It should take up at least one block of space. 


$ SHOW QUOTA 
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i. $ RUN SYSSSYSTEM: SYSMAN | 
SYSMAN> DISKQUOTA SHOW /DEVICE=CLASS DISK [320,10] 


Substitute the name of your class volume for CLASS_DISK, and your own UIC for 
[320,10]. The utility modifies the quota file dynamically, so it recorded the blocks you 
used for the file when you created it. 


5. SYSMAN> DISKQUOTA MODIFY [320,10] /PERMQUOTA=2000 /OVERDRAFT=300 
Substitute the appropriate values that correspond to your record. 

6. SYSMAN>EXIT 

7. $ SET DEFAULT SYSSSYSTEM: 


8. $ RUN SYSMAN 
SYSMAN> DISKQUOTA SHOW /DEVICE=CLASS DISK [320,10] 


Substitute the name of your class volume for CLASS_DISK and your own UIC for [320,10]. 
If you do not enter the /DEVICE qualifier, the utility uses the quota file for the current default 
disk (the system disk), if it exists. That file does not contain your quota record. 
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LABORATORY EXERCISES — USING LOGICAL NAME 
TABLES 


Laboratory Exercise 2-1 — Logical Name Tables 
1. Use the DCL command SHOW LOGICAL to find out the physical device name of your 
default login device. 


2. Find out the physical device name of the default login device for one of your fellow students, 
given his or her user name. 


3. Assign an additional logical name to the device whose name you found in question 1: 


* Make your user name part of the logical name. For example, if your user name is 
LAB10, you could call your logical name LAB10_ DISK. 


* Assign it in the system table. 
- Give it the attributes CONCEALED and TERMINAL. 
Use the name in one or more DCL commands to verify that it works. 
4. Use SYSMAN to make the same logical name assignment clusterwide. 
If possible, log in to another node of the cluster and verify that the name is defined. 
Finally, use SYSMAN again to deassign your logical name clusterwide. 
5. Find out whether the logical name SYS$SYSROOT has any translation attributes defined. 


6. In the command procedure, SYS$STARTUP:SYLOGICALS.COM, look for the ASSIGN or 
DEFINE commands. (Hint: use the DCL SEARCH command.) 


For each logical name you see assigned in this procedure, use the SHOW LOGICAL or 
SHOW TRANSLATION command to verify that it is defined on the system. 
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Solutions to Laboratory Exercise 2-1 — Logical Name Tables 


1. In the following example, $1$DUA12 is the physical device name. 


$ SHOW LOGICAL SYSSLOGIN 


"SYSSLOGIN" = "USERDISK1: [MATTHEWS]" (LNMSJOB_ 807262A0) 
$ SHOW LOGICAL USERDISK1 
"USERDISK1" = "$1S$DUA12:" (LNMSSYSTEM TABLE) 


Instead of SYS$LOGIN, you could have used the logical name SYS$LOGIN_DEVICE or 
SYS$SCRATCH. You could use SYS$DISK if you have not used SET DEFAULT to change 
your default device. 


2. In the following example, $100$DUA1 is the physical device name. 


$ RUN SYSSSYSTEM: AUTHORIZE 
UAF> SHOW STUDENT9 


Username: STUDENT9 Owner: System & Network Mgt II 
Account: LAB UIC: [22,11] ([LAB, STUDENT] ) 
CLI: DCL Tables: 


Default: LABDISK: [STUDENT9] 


UaF> 


$ SHOW LOGICAL LABDISK 
"LABDISK" = "$100SDUA1:" (LNMSSYSTEM TABLE) 


3. In the following example, $1$DUA12 is the physical device name. 


$ ASSIGN /SYSTEM /TRANSLATION_ATTRIBUTES= (CONCEALED, TERMINAL) - 
$_ $1$DUA12: LAB10 DISK 
$ DIRECTORY LAB10 DISK: [000000] 


Directory LAB10O DISK: [000000] 


000000.DIR;1 BACKUP .SYS;1 BADBLK.SYS;1 BADLOG.SYS 
BADLOG. SYS; 1 BITMAP .SYS;1 CONTIN.SYS;1 CORIMG.SYS;1 
INDEXF.SYS;1 LAB1.DIR; 1 LAB2 .DIR;1 LAB3.DIR;1 
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$ RUN SYSSSYSTEM: SYSMAN 

SYSMAN> SET ENVIRONMENT/CLUSTER 

%SYSMAN-I-ENV, current command environment: 
Clusterwide on local cluster 
Username LAB10 will be used on nonlocal nodes 


SYSMAN> DO ASSIGN /SYSTEM /TRANSLATION=CONCEALED $1S$DUA12: LAB10 DISK 
%SYSMAN-I-OUTPUT, command execution on node BARNUM 

%DCL-~I-SUPERSEDE, previous value of LAB10O DISK has been superseded 
%SYSMAN-I-OUTPUT, command execution on node NODE2 


SYSMAN> | CTRL/Z 


$ SET HOST NODE2 


$ SHOW LOGICAL LAB10 DISK 
"LAB10 DISK" = "S1SDUA12:" (LNMSSYSTEM TABLE) 
S$ LOGOUT 
Process LAB10 logged out at 5-SEP-1991 17:39:21.66 
S$ RUN SYSSSYSTEM:SYSMAN 
SYSMAN> SET ENVIRONMENT/CLUSTER 
SSYSMAN-I-ENV, current command environment: 
Clusterwide on local cluster 
Username LAB10 will be used on nonlocal nodes 


SYSMAN> DO DEASSIGN /SYSTEM LAB10 DISK 
%SSYSMAN-I-OUTPUT, command execution on node BARNUM 
%$SYSMAN-I-OUTPUT, command execution on node NODE2 


SYSMAN> 


The logical name has the attributes CONCEALED and TERMINAL. (So does one of its 
equivalence names, SYSSCOMMON.) 


$ SHOW LOGICAL SYSSSYSROOT /FULL 


"SYSSSYSROOT" [exec] = "S1SDUA0:[SYS11.]" [concealed,terminal] (LNMSSYSTEM_TA 
BLE) 
= "SYSSCOMMON:" 
1 “SYSSCOMMON" [exec] = "S1SDUAO: [SYS11.SYSCOMMON.]" [concealed,terminal] (LNMS 


SYSTEM_TABLE) 
$ SEARCH SYSSSTARTUP: SYLOGICALS.COM /MATCH=OR DEFINE, ASSIGN 


System logical names vary from system to system. See your instructor if you need help 
with this exercise. 
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LABORATORY EXERCISES — QUEUE MANAGEMENT 


Laboratory Exercise 3-1 — Queues 


The following exercises allow you to practice DCL commands needed to create, manipulate, 
view, and delete queues. 


Perform the following laboratory exercises at an interactive terminal. 


1. 
2. 


Issue a command that lists the allocated devices. 


Use the command procedure LOGIN.COM in your main directory as a sample to place in 
the print and batch queues. To place several entries in the print queues, issue the following 
commands: 


$ PRINT/HOLD LOGIN.COM 

$ PRINT/HOLD/QUEUE=LPAO0 LOGIN.COM 
Examine the print queues with the following commands: 

S SHOW QUEUE queue_name 

$ SHOW QUEUE/DEVICES/ALL 
Place several copies of the LOGIN.COM file into the batch queues by issuing the following 
commands: 


$ SUBMIT/HOLD LOGIN.COM 
$ SUBMIT/HOLD/PRIORITY=1 LOGIN.COM 
$ SUBMIT/HOLD/PRINT=LPA0: LOGIN.COM 


NOTE 


These files are not activated in the batch queue because of the the 
HOLD qualifier. Again, using the HOLD qualifier allows you to examine 
the batch jobs with the correct DCL commands. 


As before, the system returns a job number for each SUBMIT command you issue. Record 
these numbers for later use. 
Examine the batch queues with the following commands: 


$ SHOW QUEUE/BATCH 
$ SHOW QUEUE/BATCH/ALL 


Notice the different information obtained from each batch queue command. Examine the 
information given with each job. 
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5. Using the job entry numbers for each print and batch job, delete those jobs from the queues 
using the command: . 


$ DELETE/ENTRY=job_ entry number queue_name 
For example, if the system returns: 

JOB SYSTEM (queue SYSSPRINT, entry 390) holding 
delete the job with the DCL command: 

$ DELETE/ENTRY=390 SYSSPRINT 


Using the job entry numbers you recorded, delete any remaining jobs from the queue. If 
problems arise, use the HELP command (for example, HELP DELETE/ENTRY) and the 

VMS DCL Dictionary to get more information. If you still have trouble deleting the entries, 
contact the instructor. 
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Solutions to Laboratory Exercise 3-1 — Queues 


1. Issue a command that lists the allocated devices. 
$ SHOW DEVICES/FULL 
No solution needed. 
No solution needed. 


No solution needed. 


OF a NN 


No solution needed. 


Queue Management — Chapter 3 Laboratory Exercises 13-19 


Laboratory Exercise 3-2 — Batch Queues 


Preparation for this lab exercise: 


10. 
11. 
12. 
13. 


Set your default to your main directory. 


Use an editor or the CREATE command to create a command procedure that you can use 
in the following exercise. Name this file B;COM. Include the following commands: 


$ SHOW TIME 

$ SHOW SYSTEM 

$ SHOW ENTRY/FULL 
$ SHOW QUEUE 


Use one command to create and start a batch queue called username_BATCH (for 
example: SMITH_BATCH). 


If you get an error message indicating insufficient privilege, remind your instructor that you 
need OPER privilege to complete this laboratory exercise. 


Submit B.COM on hold to be run as a batch job in your batch queue. 


Look at the contents of the queue username_BATCH. The first line of output from a SHOW 
QUEUE command lists the type, name, and status of the queue. Get used to checking this 
line to see if the queue is stopped or paused. 


For the rest of the laboratory exercise, look at the contents of all batch queues whenever 
you change anything. 


Create and start a second batch queue called SLO_username (for example: SLO_SMITH) 
with a base priority of 2. This time use separate commands to create and start the queue. 


Submit B.COM as a batch job to the SLO_username queue. 


Use the SHOW SYSTEM command to see the name of the batch process executing 
B.COM. 


Submit B.COM on hold to the SLO_username queue. 

Submit B.COM to the SLO_username queue. 

Submit B.COM on hold to the username_BATCH queue. 

Transfer all jobs from the username_BATCH queue to the SLO_username queue. 
Stop the username_BATCH and SLO_username queues. 

Delete the holding entries in the SLO_username queue. 


Delete the username_BATCH and SLO_username queue. List all batch queues. 
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Solutions to Laboratory Exercise 3-2 — Batch Queues 


1. Use one command to create and start a batch queue called username_BATCH. 
$ INITIALIZE/QUEUE/BATCH/START username BATCH 

2. Submit B.COM on hold to be run as a batch job in the queue username_BATCH. 
$ SUBMIT/HOLD/QUEUE=username_BATCH B.COM 


The SUBMIT command sends jobs to the SYS$BATCH queue by default, so the following 
command does the same thing: 


$ SUBMIT/HOLD B.COM 


3. Look at the contents of the queue username_BATCH. The first line of output from a SHOW 
QUEUE command lists the type, name, and status of the queue. Get used to checking this 
line to see if the queue is stopped or paused. 


$ SHOW QUEUE username BATCH 

The following commands give additional information: 

‘$ SHOW QUEUE/FULL username_BATCH | 

The status column indicates the status of the job you submitted. 


4. Create and start a batch queue called SLO_username with a base priority of 2. This time 
use separate commands to create and start the queue. 
$ INITIALIZE/QUEUE/BATCH/BASE PRIORITY=2 SLO_username 


$ START/QUEUE SLO_username 
$ SHOW QUEUE/FULL/BATCH 


5. Submit B.COM as a batch job to the SLO_username queue. 


$ SUBMIT/QUEUE=SLO_ username B.COM 
$ SHOW QUEUE/FULL SLO username 


Notice that the priority of the job is different from the priority of the queue. Again, note the 
status of the job you submitted. 


6. Use the SHOW SYSTEM command to see the name of the batch process executing 
B.COM. 


$ SHOW SYSTEM 


The process name is BATCHxxx, where xxx is the job entry number. 
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7. Submit B.COM on hold to the SLO_username queue. 


$ SUBMIT/HOLD/QUEUE=SLO_username B.COM 
S$ SHOW QUEUE/FULL/BATCH 


The order of the qualifiers is not important, as long as they are all included in the command. 


8. Submit B.COM to the SLO_username queue. 


$ SUBMIT/QUEUE=SLO_username B.COM 
S$ SHOW QUEUE/FULL SLO_ username 


9. Submit B.COM on hold to the username_BATCH queue. 


$ SUBMIT/HOLD/QUEUE=username_BATCH B.COM 
$ SHOW QUEUE/FULL/BATCH 


10. Transfer all jobs from the username_BATCH queue to the SLO_username queue. 


$ ASSIGN/MERGE SLO_ username username_BATCH 
$ SHOW QUEUE/FULL/BATCH 


Notice that all jobs have been transferred to the SLO_username queue. 


11. Stop the username_BATCH and SLO_username queues. 
$ STOP/QUEUE/NEXT SLO username 


$ STOP/QUEUE/NEXT username_BATCH 
$ SHOW QUEUE/FULL/BATCH 


12. Delete the holding entries in the SLO_username queue. 


$ DELETE/ENTRY=entry-number SLO_username 
Repeat this command for each entry on hold in the queue. 


13. Delete the username_BATCH and SLO_username queue. List all batch queues. 


S DELETE/QUEUE SLO_username 
S DELETE/QUEUE username _BATCH 
S$ SHOW QUEUE/FULL/BATCH 
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Laboratory Exercise 3-3 — Print Queues 


The following exercises allow you to practice DCL commands needed to create, manipulate, 
view, and delete print queues. Keep in mind that the commands used are similar to the 
commands for batch queues, except they are missing the /BATCH qualifier. 


Preparation for this lab exercise: 


Copy your B.COM file to A.DAT so you will have two files to work with. 


1. Create and start a generic queue named SYS$PRINT. 


2. Create a print execution queue. SYS$PRINT sends jobs to the queue you create. The print 
execution queue should be given the name of the fastest printer on your system (or the 
printer assigned to you for the course). All jobs printed through this queue should include 
a flag page. Start the queue. 


3. Create the symbol SQ to look at the contents of each device queue. 


$ SQ=="SHOW QUEUE/FULL/DEVICE" 


Use this symbol instead of the command. The symbol is faster to enter, and you will learn 
more about queues if you look at their contents often (especially after each change). 


4. Send A.DAT on hold to the SYS$PRINT generic queue to be printed. 


5. Send B.COM directly to the print execution queue to be printed. Look at the contents of 
each device queue (quickly). 


6. Release the A.DAT job in the SYS$PRINT queue so that it will be printed. 
7. Look at the contents of the device queues, and check the line printer output. 


8. While the files are printing, pretend that the line printer is jammed. Fix the line printer, and 
requeue the file. 


9. Abort the current job printing on the line printer. Display the contents of the queue and note 
the status of the job you just aborted. 


10. Enable your terminal as an operator’s console. 


11. Print the file A.DAT on SYS$PRINT, using the /OPERATOR qualifier to send a message to 
the operator. 


12. When notified operator assistance is requested, issue a SHOW QUEUE/FULL command 
on the print execution queue. Note the first line, which reports status of the device. 


13. Start the queue again. 


14. Display the contents of the execution queue. 
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Solutions to Laboratory Exercise 3-3 — Print Queues 


The nin some of the answers corresponds to the entry number given to the job when the PRINT 
command was typed. Each job has a unique entry number. When you type these commands to 
see the answers, substitute the entry numbers given by your system in the appropriate places. 


The device name LPAO: can be replaced by the device name of the printer you are using so 
the command will work on your system. 
1. Create and start a generic queue named SYS$PRINT. 
$ INITIALIZE/QUEUE/GENERIC/START SYSSPRINT 
2. Create a print execution queue. SYS$PRINT sends jobs to the queue you create. The print 
execution queue should be given the name of the fastest printer on your system (or the 


printer assigned to you for the course). All jobs printed through this queue should include 
a flag page. Start the queue. 


$ INITIALIZE/QUEUE/SEPARATE=FLAG LPAO 


3. Create the symbol SQ to look at the contents of each device queue. 


$ SQ=="SHOW QUEUE/FULL/DEVICE" 
$ SQ 


The symbol lists the complete contents of all device queues. You should see two queues, 
named LPAO and SYS$PRINT. 


4. Send A.DAT on hold to the SYS$PRINT generic queue to be printed. 


$ PRINT/QUEUE=SYSSPRINT/HOLD A.DAT 


The PRINT command automatically sends jobs to the SYS$PRINT queue if it exists, so the 
following command does the same thing: 


$ PRINT A.DAT 


5. Send B.COM directly to the print execution queue to be printed. Look at the contents of 
each device queue (quickly). 


$ PRINT/QUEUE=LPAO B.COM 
$ SQ 


The contents of the queues should be A.DAT in SYS$PRINT on hold, and B.COM in LPAO 
with printing status. 


6. Release the A.DAT job in the SYS$PRINT queue so that it will be printed. 


$ SET ENTRY/RELEASE n 


(Where nis the entry number) 
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10. 


11. 


12. 


13. 


14. 


Look at the contents of the device queues, and check the line printer output. 


$ SQ 


A.DAT should have printing status on the LPAO queue. B.COM should have been printed 
first, followed by the file A.DAT. 


While the files are printing, pretend that the line printer is jammed. Fix the line printer, and 
requeue the file. 

$ STOP/QUEUE/REQUEUE LPAO 
Abort the current job printing on the line printer. Display the contents of the queue and note 
the status of the job you just aborted. 


$ STOP/QUEUE/ABORT LPAO 


Enable your terminal as an operator’s console. 
$ REPLY/ENABLE 
Print the file A.DAT on SYS$PRINT:, using the /OPERATOR qualifier to send a message to 
the operator. 
$ PRINT/OPERATOR="Long job coming through -- check paper." 
When you are notified that operator assistance is requested, issue a SHOW QUEUE/FULL 


command on the print execution queue. Notice the first line, which reports the status of the 
device. 


$ SHOW QUEUE/FULL LPAO 


Start the queue again. 


$ START/QUEUE LPAO 


Display the contents of the execution queue. 


$ SHOW QUEUE/FULL LPAO 
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LABORATORY EXERCISES — PERFORMING 
BACKUPS AND RESTORES 


Laboratory Exercise 4-1 — Backup 


This exercise allows the user to perform backup procedures without a tape drive. Perform the 
following exercise at an interactive terminal. Refer to the Appendix in the Performing Backups 
and Restores chapter if you need help with this exercise. 


1. 


Create a new subdirectory one level below your main directory. Name the new subdirectory 
ANDY. 


Using the BACKUP utility, copy the file A.DAT to the new subdirectory. Create a new file 
and NOT a save set. 


Using the BACKUP utility, copy the same file A.DAT to the new subdirectory. Create a save 
set named BEGIN.BCK and NOT a file copy. 


Using the /LIST qualifier, examine the contents of your newly created save set. 
Delete both A.DAT and BEGIN.BCK from the subdirectory. 


Create a save set named COMS.BCK in the subdirectory ANDY that contains all command 
procedure files in the directory SYS$EXAMPLES:. The BACKUP utility will not copy the 
files that you have no privilege to access. 


Using the /LIST qualifier, verify that the backup save set contains the intended command 
procedure files. 


Select several of the command procedures and copy them from the save set to the 
subdirectory ANDY one at a time. 
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Solutions to Laboratory Exercise 4-1 — Backup 
Substitute your directory name for STUDENT in the following examples. 
1. Create a new subdirectory one level below your main directory. Name the new subdirectory 
ANDY. 
$ CREATE/DIRECTORY (STUDENT .ANDY] 
2. Using the BACKUP utility, copy the file A.DAT to the new subdirectory. Create a new file 
and NOT a save set. 


S BACKUP A.DAT 
_To: [STUDENT .ANDY] 


3. Using the BACKUP utility, copy the same file A.DAT to the new subdirectory. Create a save 
set named BEGIN.BCK and NOT a file copy. 


$ BACKUP A.DAT 
_To: [STUDENT .ANDY] BEGIN.BCK/SAVE_SET 


4. Using the /LIST qualifier, examine the contents of your newly created save set. 


$ BACKUP/LIST [STUDENT.ANDY]BEGIN.BCK/SAVE_SET 


5. Delete both ADDAT and BEGIN.BCK from the subdirectory. 
$ DELETE [STUDENT.ANDY]*.*;* 
6. Create a save set named COMS.BCK in the subdirectory ANDY that contains all command 


procedure files in the directory SYS$EXAMPLES:. The BACKUP utility will not copy the 
files that you have no privilege to access. 


$ BACKUP SYSSEXAMPLES:* .COM 
_To: [STUDENT .ANDY] COMS .BCK/SAVE_SET 


7. Using the /LIST qualifier, verify that the backup save set contains the intended command 
procedure files. 
$ BACKUP/LIST [ STUDENT. ANDY ]COMS.BCK/SAVE_SET 


8. Select several of the command procedures and copy them from the save set to the 
subdirectory ANDY one at a time. 


$ BACKUP 
_From: [STUDENT.ANDY]COMS.BCK/SAVE_SET/SELECT=file 
_To: [STUDENT . ANDY] 
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Laboratory Exercise 4-2 — Backup to Tape (Optional) 


If the following equipment is available to you, perform the following procedures. 
Use the scratch tape provided by the instructor for the following problems. 


1. 
2. 


oS Se Se ee 


11. 
12. 
13. 


14. 


Allocate a tape drive and load a tape on the drive. 


Initialize and mount a new magnetic tape. If the tape is not new and does not belong to 
you, you will need VOLPRO privilege. Mount the tape using the following command: 


$ MOUNT/OVERRIDE=ID tape label 

Copy several files to the tape. 

List the files on the tape. 

Dismount the tape, allowing it to rewind completely and go off line. 
Remove the tape from the drive. 

Mount a small tape as the first tape in a volume set. 

Copy the files in SYS$SYSTEM: to the tape. 


When the tape is full, the system requests another tape. Mount the next tape and allow the 
procedure to continue. 


. Dismount and deallocate the tape drive. 


Do the following exercises only if more than one tape drive is attached to your system. 
Allocate two tape drives and load a tape on each. 
Initialize the first tape in the set. 


Mount the tapes as a multivolume set, using the /INITIALIZE=CONTINUOUS qualifier to 
initialize the tapes before you write to them. 


Copy SYS$SYSTEM: to the tape set. 
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Solutions to Laboratory Exercise 4-2 — Backup to Tape (Optional) 


1. Allocate a tape drive and load a tape on the drive. 
$ ALLOCATE MTAO: 
2. Initialize and mount a new magnetic tape. 
$ INITIALIZE MTAO: label 
Mount the tape using the following command: 
$ MOUNT/OVERRIDE=ID tape label 
3. Copy several files to the tape. 
$ COPY files MTAO: 
4. List the files on the tape. 
$ DIRECTORY MTAO: 
5. Dismount the tape, allowing it to rewind completely and go off line. 
$ DISMOUNT MTAO: 
6. Remove the tape from the drive. 
See the Handling Peripherals chapter. 
7. Mount a small tape as the first tape in a volume set. 
$ MOUNT MTAO: label 
8. Copy the files in SYS$SYSTEM: to the tape. 
$ COPY SYSSSYSTEM:*.*;* MTAO: 


9. When the tape is full, the system requests another tape. Mount the next tape and allow the 
procedure to continue. 


See chapter text. 
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10. Dismount and deallocate the tape drive. 


$ DISMOUNT MTAO: 
$ DEALLOCATE MTAO: 


11. Allocate two tape drives and load a tape on each. 


$ ALLOCATE MTAO: 
$ ALLOCATE MTA1: 


12. Initialize the first tape in the set. 
$ INITIALIZE MTAO: label 


13. Mount the tapes as a multivolume set, using the /INITIALIZE=CONTINUOUS qualifier to 
initialize the tapes before you write to them. 


$ MOUNT/OVERRIDE=ID/INITIALIZE=CONTINUOUS MTAO:,MTA1: 
14. Copy SYS$SYSTEM: to the tape set. 


$ COPY SYSSSYSTEM: MTAO: 
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LABORATORY EXERCISES — INTRODUCTION TO 
SYSTEM CUSTOMIZATION 


Laboratory Exercise 5-1 — Customization 


1. Type (or print) the following system startup files and examine them: 


a. 
b. 
c. 


d. 


SYS$MANAGER:SYLOGICALS.COM 
SYS$MANAGER:S YPAGSWPFILES.COM 
SYS$MANAGER:SYCONFIG.COM 
SYS$MANAGER:SYSTARTUP_V5.COM 


2. Optional - Create TERMINALS.COM in your own directory. This procedure should set 
the permanent characteristics of the terminals on your system according to the following 


information. 

a. Assume that you have eight terminals. 

b. Set up some fast terminals and some slow terminals. 

c. Protect at least three terminals from allocation by processes other than those with a 
[001,004] UIC. 

d. Four of the terminals are VT200 series terminals. 

e. Three are VT300 series terminals. 

f. One is an LA120 hardcopy terminal. 

g. The LA120 is attached through a modem. 


The other terminals are attached through direct lines. 


Include the name of the owner and office number where the terminal is located in a 
comment for each terminal. 
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3. Optional - Create an alternate SYSTARTUP_V5.COM in your own directory. Do not execute 
this procedure to verify your work. Instead, look at the answers provided in this chapter. 
The procedure should include commands to do the following: 


a. 


Mount the class disk (label = CLASS) on the device DUA1:. Be sure it will be accessible 
to all users. Assign the disk the logical name CLASS_DISK. 


Assume that a directory named PROGRAMS.DIR has been created on the system disk 
to contain site-specific programs. Define a system logical name for this directory. 


Create and start the following queues (if possible). 
¢ SYS$PRINT (generic queue) 
¢ A print execution queue 


— Make sure the printer supports lowercase characters and includes a flag page 
on each job printed. 


* SYS$BATCH (batch execution queue) 
— Set the job limit at two and the priority at three. 
* BIGJOB (batch execution queue) 
— Set the job limit at one and the priority at two. 
— Do not start this queue. 
Invoke SYS$6MANAGER:TERMINALS.COM 
Define the logical names SYS$ANNOUNCE and SYS$WELCOME 


Rename the second highest version of the operator log to OPERATOR.OLD. Print 
OPERATOR.OLD, and have the system delete the file for you after it has been printed. 


Restrict the number of interactive users to 35. 


Send a message to all terminals telling users that the system is now up and ready for 
use, and log out. 
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Solutions to Laboratory Exercise 5-1 — Customization 


1. The purpose of looking at the system startup files is to familiarize yourself with the contents 
of these files as a whole. The following are the commands that you would use to type out 
the system startup files. 


a. $ TYPE SYSSMANAGER: SYLOGICALS.COM 

b. $ TYPE SYSSMANAGER: SYPAGSWPFILES.COM 
C. $ TYPE SYSSMANAGER: SYCONFIG.COM 

d. $ TYPE SYSSMANAGER: SYSTARTUP_V5.COM 


2. The following is a sample TERMINALS.COM file. This procedure meets the specifications 
of the problem, but it is not the only answer. If your procedure contains most of the same 
kinds of statements, it is probably also correct. 


$!TERMINALS .COM 

$! 

$! This file sets up the permanent characteristics of the 
$! terminals on this system. This procedure is typically 
$! invoked from SYSTARTUP_V5.COM. 


$! 

$ SET NOON 

$! 

$ SET TERM/PERM/NOMODEM- 

/VT200/SPEED=300 TTAO: {J.Smith E15 

$ SET TERM/PERM/NOMODEM-— 

/VT200/SPEED=2400 TTA1: 'N.Hae E16 

$ SET TERM/PERM/NOMODEM-— 

/VT200/SPEED=9600 TTA2: !F.Chi E17 

$ SET TERM/PERM/NOMODEM- 

/VT200/SPEED=9600 TTA3: 'P.Jones E18 

$ SET TERM/PERM/NOMODEM- 

/VT300/SPEED=2400 TTA4: 'A.Steel E19 

S$ SET TERM/PERM/NOMODEM-— 

/VT300/SPEED=9600 TTAS: !J.Howland FO1 

$ SET TERM/PERM/NOMODEM- 

/VT300/SPEED=9600 TTA6: 'M.Carter FO2 

$ SET TERM/PERM/MODEM-— 

/AUTOBAUD/LA120 TTA7: !D.Trevor Dial-up 

$! 

$! NOTE: For the LA120 terminal, the speed is 

$! set automatically by /AUTOBAUD to 9600. 

$! 

$!Give [001,004] ownership of three terminals: 

$! 

S$ SET PROT=(S,0:R,G,W) /DEVICE/OWNER_UIC=[001, 004] TTAO: 
$ SET PROT=(S,0:R,G,W) /DEVICE/OWNER_UIC=[001,004] TTAS: 
$ SET PROT=(S,0:R G,W) /DEVICE/OWNER_UIC=[{001,004] TTA?: 


? 


$! 
$! NOTE: All users can log in on these terminals, but users 
$! with a UIC of [001,004] can also allocate them. 
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3. The following is a sample SYSTARTUP_V5.COM procedure. This procedure meets the 
specifications of the problem, but it is not the only answer. If your procedure contains most 
of the same kinds of statements, it is probably also correct. 


$! SAMPLE SYSTARTUP_V5.COM 

$! 

S$! This procedure sets up the system environment according 
$! to the resources available and functions performed on 
$! this system. 

$! 


' 
a OoNRpeeua DUA1: CLASS CLASS DISK 
{ 
e Keer cavern SYSSSYSDEVICE:PROGRAMS.DIR PROGRAMS 
' 
Start up PRINT and BATCH queues 
1 
| iueneauipe Japeon/cENEC/omne SYSSPRINT 
{ 
aoe PRINTER LPAO: /LOWER 
$ SET DEVICE LPAO:/SPOOLED 
! 
Se Tee LPAOQ 
t 
eee ice aun Ee ee SYSSBATCH 
{ 
Eitan tbe SaauE eancy SERS BIGJOB 
! 
Ee avSuncen ete nenee 
! 
S esiaeery "System number 239 —~ VMS " SYSSANNOUNCE 
$ ASSIGN/SYSTEM "Welcome to system 239" SYSSWELCOME 
1 
Uda OPERATOR.LOG;-1 OPERATOR.OLD 
$ PRINT/DELETE OPERATOR.OLD 


ot 

$ SET LOGIN/INTERACTIVE=35 

$! 

$! NOTE: The SET LOGIN/INT command should be placed at the end 
$! of the procedure, so users cannot log in while the 

$! procedure is executing. 

$! 

$! 

$ REPLY/BELL/ALL "System 239 is ready for use" 

$! 


$ LOGOUT/BRIEF 
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Laboratory Exercise 5-2 — Customization 


You need write access to the MFD of the student disk and to the system authorization files to 
do this lab. 


hs 


Create an account called PAYROLLn, where n is a number assigned by your instructor. 
The group number assigned to workers in payroll is 322. Choose any member number 
from 60-377 (octal) that is not in use. Also create a directory and a disk quota entry for the 
account. 


Log in to the new account and create a small file in its directory to verify your work. 


This account is only allowed to run a data entry program ENTRY.EXE. The name of the 
command procedure used to run the program is DATA.COM. Your instructor can tell you 
what directory these files are in. 


Modify the UAF record so that DATA.COM runs automatically when you log in to the 
PAYROLLn account, and you cannot reach the DCL prompt. 


Log in as PAYROLLn. The DATA.COM procedure should execute automatically. The 
password for the procedure is GO. The procedure executes ENTRY.EXE. When ENTRY.EXE 
requests input, type in three numbers separated by commas. 


To test your work, log out and log in as PAYROLLn several times. Each time, try to cause 
the DCL prompt to appear. (Suggestions: enter CTRL/Y; enter incorrect data at various 
points; enter the wrong password; and so forth.) 


4. Do whatever is necessary to remove the account PAYROLLn from the system. 
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Solutions to Laboratory Exercise 5-2 — Customization 


1. To add an account, run the AUTHORIZE and DISKQUOTA utilities and create a UFD as 
shown below. ; 


$ SET DEFAULT SYSSSYSTEM 
$ RUN AUTHORIZE 
UAF>SHOW/BR [322,*] 


(Output shows 63 has not been used as a member number yet) 


UAF>ADD PAYROLL3 /PASSWORD=JOE- 
_UAF>/UIC=[322, 063] - 
_UAF>/DEVICE=student_disk- 
_UAF>/DIRECTORY=[PAYROLL3] 

UAF>EXIT 

$ 

$ SET DEFAULT student_disk: [000000] 

$ 

$ RUN SYSSSYSTEM: SYSMAN 

SYSMAN> DISKQUOTA ADD PAYROLL3 /DEVICE=student_ disk - 
_SYSMAN> /PERMQUOTA=5000/OVERDRAFT=500 
SYSMAN> EXIT 

$ 

$ CREATE/DIRECTORY/OWNER=PAYROLL3 [PAYROLL3] 
$ 


You should have been able to create a test file successfully. If not, look at these solutions 
carefully, set up the account properly, and try again. 


Check the owner UIC of the directory if you receive protection errors. Check the contents 
of the QUOTA.SYS file on student_disk: if you receive quota errors. 


2. To modify the account so it can only run the DATA.COM procedure, use the AUTHORIZE 
utility to make the account captive. 


UAF>MODIFY PAYROLL3 /LGICMD=student_disk: [PAYROLL] DATA. COM- 
_UAF>/FLAGS= (CAPTIVE, LOCKPWD, DISCTLY) 


3. If you enter incorrect answers to the DATA.COM procedure or the ENTRY program, you 
are logged out. If you enter letters as data to ENTRY, instead of numbers, you are logged 
out. If you enter a CTRL/Y key sequence, you are logged out. 


4. To remove the account completely, you must delete all subdirectories and files in 


[PAYROLL3], remove PAYROLL3.DIR, remove the PAYROLLS entry from the quota file, © 
and remove the UAF record from the SYSUAF.DAT file. 
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Laboratory Exercise 5-3 — Customization 


In these exercises, you use a command procedure called HARMLESS _AUTOGEN.COM. Your 
instructor should tell you in what directory to find this procedure. 


HARMLESS AUTOGEN mimics the actions of SYS$UPDATE:AUTOGEN.COM, except that it 
does not create or modify any system files or shut down the system. Instead, it creates files in 
your default login directory (SYS$LOGIN:). 


1. 


Create a file MODPARAMS.DAT in your default directory SYS$LOGIN: (not in 
SYS$MANAGER:). Have it contain values for the following: 


¢ Preserve the values of parameters SCSNODE and SCSSYSTEMID for this system 
(use the values that appear in SYS$SYSTEM:MODPARAMS.DAT). 


- Set VIRTUALPAGECNT to allow a program to use 20 megabytes (40960 pages) of 
virtual memory. 


« Set RJOBLIM to allow only four remote terminals to log in concurrently. 
* Increase the number of global sections by six, and the number of global pages by 300. 


Run HARMLESS _AUTOGEN so that it starts at the earliest possible phase and ends with 
the phase that reports on system file sizes. 


Examine SYS$LOGIN:AGEN$FEEDBACK.REPORT and SYS$LOGIN:SETPARAMS.DAT. 
(You may want to print them.) Verify that AUTOGEN generated correct settings for the 
parameters that you specified in MODPARAMS.DAT. If settings are incorrect, edit 
MODPARAMS.DAT and perform the previous step again. 


Run HARMLESS_AUTOGEN so that it starts by generating system parameter values and 
ends by rebooting the system. (It will not cause the system to reboot, but will display a 
message at the point where AUTOGEN would have rebooted the system.) 


Use the SYSMAN utility to examine SYS$LOGIN:AUTOGEN.PAR. For the parameters 
that you specified in MODPARAMS.DAT, verify that AUTOGEN set them correctly in 
AUTOGEN.PAR. 
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Solutions to Laboratory Exercise 5-3 — Customization 


1. Your file should be similar to the following: 


! This is a sample MODPARAMS.DAT 

; 

SCSNODE = "PANAMA" 

SCSSYSTEMID = 2278 

MIN_VIRTUALPAGECNT = 40960 ! Use MIN in case AUTOGEN calculates a higher value 
RJOBLIM = 4 

ADD_GBLSECTIONS = 6 

ADD _GBLPAGES = 300 


$ @dir:HARMLESS AUTOGEN SAVPARAMS TESTFILES 


No solution needed. 


$ @dir:HARMLESS AUTOGEN GENPARAMS REBOOT 


oOo - oO ND 


. § RUN SYSSSYSTEM: SYSMAN 

SYSMAN> PARAMETERS USE AUTOGEN.PAR 
SYSMAN> PARAMETERS SHOW SCSNODE 
SYSMAN> PARAMETERS SHOW SCSSYSTEMID 
SYSMAN> PARAMETERS SHOW LRPSIZE 
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LABORATORY EXERCISES — LAYERED PRODUCT 
INSTALLATION 


Laboratory Exercise 6-1 — Layered Product Installation 


1. Type the LMF command to display a list of licenses registered in the license database for: 
a. All licenses registered 
b. A specific layered product 

2. Type the LMF command that displays active licenses on the current node for: 
a. All active licenses 


b. A specific layered product 
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Solutions to Laboratory Exercise 6-1 — Layered Product Installation 


1. The purpose of displaying the list of all registered licenses is to begin to familiarize yourself 
with the contents of the license database. This command allows you to gain information on 
the entire database or just on specific products. 


a. S$ LICENSE LIST 


b. 


$ LICENSE LIST FORTRAN 


Press Ctrl/Z to exit, use arrow keys to scroll. 


License Management Facility 

License Database File: SYSSCOMMON: [SYSEXE] LMF SLICENSE.LDB;1 
Created on: 9-MAY-1989 

Created by user: SYSTEM 

LMF Version: v1.0 

FORTRAN DEC 

FORTRAN DEC 

(End Of List] 


The SHOW LICENSE command gives you the ability to find out what products have already 


been loaded on the current node. This command will give you the entire list of active 
products or you can request information on a specific product. 


a. $ SHOW LICENSE 


b. 


$ SHOW LICENSE FORTRAN 


Active licenses on node SUPER: 


FORTRAN 


Producer: DEC 

Units: 0 

Version: 0.0 

Date: 22-AUG-1990 

Termination Date: (none) 
Availability: F (Layered Products) 
Activity: 0 

MOD_UNITS 
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Laboratory Exercise 6-2 —- Layered Product Installation 


a 


Layered Product installation — Chapter 6 


Create a license database in your own student directory. Issue the SHOW DEFAULT 
command to find out the exact device and directory name that you will need to specify 
when creating the database. 


Using the information from the following PAK, register and list the sample product ED_ 
SERV_FORTRAN. You will need to specify the /DATABASE qualifier to the REGISTER 
command to ensure you register it to your private database. 


Els HE Ab AD alae dl LICENSE SOFTWARE PRODUCT | DOCUMENT ISSUE DATE | 
ldljilgfiltia|1] PRODUCT AUTHORIZATION KEY 03-JUNE-1991 


Digital Equipment Corporation 
Maynard, Ma. 


| LICENSE ADMINISTRATION LOCATION: | ORDERED BY: Moppet Industries 

| | Ms. Bonnie Moppet 

| Digital Equipment Corporation | 123 Main St. 

| Maynard, Massachusetts | Merrimack, NH 03054 
| 

| | 

| | 


KREKEKKE KK KKK KKK KEK KEK RK KK KK KK KKK KKK KK KK KEK KK KKK KEK KKK K KK KK KEK KKK KKK KEK RK KKK KK KEKE 
! FOR DIGITAL INTERNAL USE ONLY 
PAK ID: 
Issuer: DEC 
Authorization Number: SQM003058 


PRODUCT ID: 
Product Name: ED SERV_FORTRAN 
Producer: DEC 


NUMBER OF UNITS: 
Number of units: 500 


KEY LEVEL: 
Version: 1.0 
Product Release Date: 


KEY TERMINATION DATE: 
Key Termination Date: 


RATING: 
Availability Table Code: 
Activity Table Code: 


MISCELLANEOUS : 
Key Options: 
Product Token: 
Hardware-Id: 


Checksum: 1-PAOI-MJNP-NCJL-DEKP 
KK RR KK RK KK KR KK KKK KKK RIK KK KK KK KKK IK IKK RK KR RRR RK RK RK IKK KKK KKK KKK EK KK KKK KAR KK KKK 
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Solutions to Laboratory Exercise 6-2 — Layered Product Installation 


1. The following is the command that you would use to create a new license database called 
PRACTICE.LDB in the directory [MORGAN.STUDENT]. Your database location would be 
different than the one used in this solution. A DIRECTORY command issued afterwards 
verifies that the file was created in the requested directory. 


$ 

$ LICENSE CREATE /DATABASE=$1$DUA1: [MORGAN. STUDENT] PRACTICE.LDB 
$ 

$ DIRECTORY 


Directory $1$DUA1: [MORGAN. STUDENT] 
PRACTICE.LDB;1 
Total of 1 file. 


2. The following are the License commands that you would enter to register and then list the 
layered product ED_SERV_FORTRAN. 


$ license register "ED SERV_FORTRAN" - 


_$ /ISSUER="DEC" — 

_$ /AUTHORIZATION=SQM003058 - 

_$ /PRODUCER=DEC - 

_$ /UNITS=500 - 

_$ /VERSION=1.0 - . 

_$ /CHECKSUM=1-PAOI-MJNP-NCJL-DEKP - 

_$ /DATABASE=$1$DUA1: [MORGAN.STUDENT] PRACTICE. LDB 

$ 

$ LICENSE LIST ED_SERV_FORTRAN /DATABASE=$1$DUA1 : [MORGAN.STUDENT] PRACTICE. LDB 
$ 


Note that the use of the SHOW LICENSE command here will default to the actual system 
database, not your practice database. There is no /DATABASE qualifier to the SHOW 
LICENSE command. 
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LABORATORY EXERCISES — REPORTING ON USER 
ACTIVITY 


Laboratory Exercise 7-1 — ACCOUNTING Utility 


1. To observe how the ACCOUNTING utility works, perform the following: 
a. Find out what classes of accounting have been enabled. 
b. Disable the recording of accounting data on print jobs. 
c. Send a file to the printer. 
d. Enable the recording of accounting on print jobs. 
e. Send a file to the printer. 


f. Generate an ACCOUNTING report in brief format that shows all print jobs completed 
within the last hour. Observe the contents of the report. 


2. Create an accounting report in full format that shows all print jobs completed within the last 
hour. Send the report directly to the printer. Collect the output and observe the format and 
contents of the report. 

3. Use the ACCOUNTING utility to examine the following record types: 

a. Login failures (in brief format) 
b. Interactive job terminations (in brief format) 
c. Process terminations (in brief format) 


d. System initializations (in full format) 


4. Use the ACCOUNTING utility to display a summary report of the accounting records that 
have your user name. 


5. Most direct I/O is disk I/O, so you can use ACCOUNTING to show which users make 
heaviest use of the disks. Create a report in summary format containing the data collected 


on direct I/O from interactive processes today. List the data in order by UIC, and send the 
report directly to the printer. (This can all be done in the same command.) 


6. Create a summary report that shows how many batch jobs have completed in each hour. 


7. Find out whether anyone has tried and failed to log in to the SYSTEM account. » 
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Solutions to Laboratory Exercise 7-1 — ACCOUNTING Utility 


1. Enter the following commands to observe how the ACCOUNTING utility works: 
a. $ SHOW ACCOUNTING 
b. $ SET ACCOUNTING/DISABLE= (PRINT) 
C. S$ PRINT FILE.TXT 
Substitute the name of your file for FILE. TXT. 
d. S$ SET ACCOUNTING/ENABLE= (PRINT) 
@. S$ PRINT FILE.TXT 
f. $ ACCOUNTING/TYPE=PRINT/SINCE=14: 00 
Substitute an appropriate time for 14:00. Note that the report contains a brief description 
of your print jobs (if they have already completed) as well as descriptions of other 
jobs. 
2. $ ACCOUNT ING/FULL/TYPE=PRINT/SINCE=14 :00/OUTPUT=LPA0: 
Substitute an appropriate time for 14:00 and the device name of your line printer for LPAO:. 
The colon (:) indicates that LPAO: is a device and not a file specification. If the colon is 
omitted, the output from the report is stored in a file named LPAO.LIS. 
3. Enter the following commands to use the ACCOUNTING utility: 
a. S$ ACCOUNTING/TYPE=LOGFAIL 
b. $ ACCOUNTING/PROCESS=INTERACTIVE 
C. $ ACCOUNTING/TYPE=PROCESS 
d. $ ACCOUNTING/FULL/TYPE=SYSINIT 
4. $ ACCOUNTING /SUMMARY=USER /REPORT=RECORDS /USER=SMITH 


Substitute your user name for SMITH. 


5. $ ACCOUNTING /SUMMARY=UIC - 
_$ /REPORT=DIRECT_IO /SINCE=00:00 /OUTPUT=LPAO: 


Substitute the device name of your line printer for LPAQ: The information in the report is 
organized in order by UIC. 


6. $ ACCOUNTING /TYPE=BATCH /SUMMARY=HOUR 


7. $ ACCOUNTING /USER=SYSTEM /TYPE=LOGFAIL 
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LABORATORY EXERCISES — MAINTAINING SYSTEM 
SECURITY 
Laboratory Exercise 8-1 — Passwords 


NOTE 


You must have write access to the system authorization file and SECURITY 
privilege to do this lab. 


1. Create a secondary password for your UAF record. Log out and log in. What has changed? 

2. Coordinate with the other students the creation of a system password and set the 
appropriate characteristics of your terminal so it is a system-password-required terminal. 
Log out and log in. What has changed? 


3. Create another UAF record. Set the expiration date on the new UAF record to be five 
minutes after the current time. Wait at least five minutes. Attempt to log in to the new 
account. What happens? Log in to your own account and delete the extra UAF record. 


4. Change the minimum length of the password to 16 on your own account, set a flag to 
require password generation, exit from the utility, log out and log in. 


5. Change your password with a DCL command that uses one of the choices listed by the 
generator (or generate a new list). 


6. Change your password and then try to change it again using the same password. 
7. Try to change your password to any English word. 


8. Log out and attempt to log in several times, specifying an incorrect password each time. 
Observe the output on the console terminal. 


9. Using SYSMAN, adjust the SYSGEN parameter LGI_RETRY_LIM and observe the effect. 
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Solutions to Laboratory Exercise 8-1 — Passwords 


1. S$ SET DEFAULT SYSSSYSTEM 
$ RUN AUTHORIZE 


UAF> MODIFY JONES/PASSWORD=(" ", SECRET) 
The system displays a second password prompt when you log in. 


2. Use the SET PASSWORD/SYSTEM command to create a system password. Use the 
SET TERMINAL command to modify your terminal characteristics as shown in the chapter. 
When you log in to your account after setting these up, you must enter the system password 
before you see the prompt for your user name. 


3. You will not be able to log in to the new account because it has expired. 


4. Use the /FLAGS=GENPWD qualifier to the MODIFY command in the AUTHORIZE utility to 
do this. 


5. When you enter the SET PASSWORD command, it automatically generates a list of 
passwords for you to choose from. 


6. When you set your password it adds that password to your password history file. The next 
time you set your password it checks the password you type against the password history 
file; if it finds the password there it displays the error message. 


$ SET PASSWORD 

Old password: 

New password: 

Verification: 

%SET-F-PWDNOTDIF, new password must be different from current password 


7. When you type a new password, the first thing the system does (even before it prompts 
you to type the new password verification) is to check the system password dictionary. If it 
finds the password you typed in the dictionary, you will receive an error message. 
$ SET PASSWORD 
Old password: 

New password: 


SSYSTEM-F-PWDINDIC, password found in system dictionary; please choose another 
string 


8. No answer needed. 


13-50 Laboratory Exercises Maintaining System Security — Chapter 8 


9. When you modify the LGl_RETRY_LIM, the system restricts the user to that number of 
retries before making the user start the login process over again. 


$ RUN SYSSSYSTEM: SYSMAN 

SYSMAN> PARAMETER USE ACTIVE 

SYSMAN> PARAMETERS SET LGI_ RETRY _LIM 4 
SYSMAN> PARAMETERS SHOW LGI_ RETRY LIM 


Node BOUNTY: Parameters in use: ACTIVE 


Parameter Name Current Default 


LGI_RETRY_ LIM 4 
SYSMAN> EXIT 
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Minimum 


Maximum Unit Dynamic 


255 Tries D 
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Laboratory Exercise 8-2 — Intrusion Records 


Team up with another student for this exercise. One student should use an unprivileged 
(UPRIVn) account and the other should use a privileged (SECn) account. In the following 
exercises you will try to become first a suspect and then an intruder from the UPRIVn account. 


1. 


From the UPRIVn account, SET HOST 0 and enter an invalid password and/or user name 
three times or until control is returned to the host node. 


From the SECn account, enter SHOW INTRUSION. There should be one suspect record, 
which you caused. 


Repeat this three more times or until control is returned to the host node. 


From the SECn account, enter SHOW INTRUSION. There should be one intruder record, 
which you caused. 


From the UPRIVn account, try to SET HOST 0 and log in with the correct user name 
/password to the UPRIVn account. 


Did it work? Why or why not? 


From the SECn account, try to SET HOST 0 and log in to the UPRIVn account with the 
correct user name/password. 


Did it work? Why or why not? 
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Solutions to Laboratory Exercise 8-2 — Intrusion Records 


In the following exercises you will try to become first a suspect and then an intruder from the 
UPRIVn account. 


1. From the UPRIVn account, SET HOST 0 and enter an invalid password and/or user name 
three times or until control is returned to the host node. 


$ SET HOST 0 


Username: GOSSE 
Password: 
User authorization failure 


Username: MOSSE 
Password: 
User authorization failure 


Username: KANGO 

Password: 

User authorization failure 

SREM-S-END, control returned to node _SUPER:: 


2. From the SECn account, enter SHOW INTRUSION. There should be one suspect record, 
which you caused. 


$ SHOW INTRUSION 
Intrusion Type Count Expiration Source 
NETWORK SUSPECT 3 15:48:37.01 SUPER::UPRIVN 


3. Repeat this three more times or until control is returned to the host node. 


_$ SET HOST 0 


Username: SWAN 
Password: 
User authorization failure 


Username: GORILLA 
Password: 
User authorization failure 


Username: KOALA 

Password: 

User authorization failure 

SREM-S-END, control returned to node _SUPER:: 
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4. From the SECn account, enter SHOW INTRUSION. There should be one intruder record, 
which you caused. 


$ SHOW INTRUSION 
Intrusion Type Count Expiration Source 
NETWORK INTRUDER 7 15:40:49.57 SUPER::UPRIVN 


5. From the UPRIVn account, try to SET HOST 0 and log in with the correct user name 
/password to the UPRIVn account. 


Did it work? Why or why not? 


$ SET HOST 0 


Username: UPRIVN 
Password: ‘enter correct password 
User authorization failure 


It did not work because the INTRUDER record is for any REMOTE (SET HOST) access 
Originating from your node and user UPRIVn. 


6. From the SECn account, try to SET HOST 0 and log in to the UPRIVn account with the 
correct user name/password. 


Did it work? Why or why not? 


5 SET HOST 0 


Username: UPRIVN 
Password: fenter correct password 


Yes. The INTRUDER record specifies the source of the REMOTE login, not the target 
account. So UPRIVn cannot set host to anyone, but you can SET HOST to the uprivn 
account. 
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Laboratory Exercise 8-3 — Suspect Versus Intrusion Records 


1. Create some more suspect and intruder records. 


a. DIR O"UPRIVn pwad":: — use your correct password 

b. DIR O"UPRIVn XXX":: — repeat with a different user name/password pair six or more 
times 

c. DIR O"UPRIVn pwd":: — use your correct password 
Did it work? 


2. Try logging in locally to the node you are on several times with any combination of incorrect 
user names and passwords. 


3. Enter the commands: 
a. SHOW INTRUSION/TYPE=SUSPECT 
b. SHOW INTRUSION/TYPE=INTRUDER 
c. SHOW INTRUSION 
What is the default qualifier value for /TYPE? 


4. Find an INTRUDER record relating to you and delete the record. Verify it is gone by 
entering SHOW INTRUSION/TYPE=ALL. 


Now try to get in through that source (that is, network, remote, local, and so on). 


Did it work? Why or why not? 
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Solutions to Laboratory Exercise 8-3 — Suspect Versus Intrusion 
Records 


1. Create some more suspect and intruder records. 


a. DIR O"UPRIVn pwad":: — use your correct password 

b. DIR O"UPRIVn XXX":: — repeat with a different user name/password pair six or more 
times 

c. DIR O"UPRIVn pwa":: — use your correct password 
Did it work? 


No, it did not work. The INTRUDER record is for you, as a network source (node::UPRIVn). 
Therefore, any network access from that account will be denied. 


2. Try logging in locally to the node you are on several times with any combination of incorrect 
user names and passwords. 


3. Enter the commands: 
a. SHOW INTRUSION/TYPE=SUSPECT 
b. SHOW INTRUSION/TYPE=INTRUDER 
c. SHOW INTRUSION 
What is the default qualifier value for /TYPE? 


The default qualifier is /TYPE=ALL. 
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4. Find an INTRUDER record relating to you and delete the record. Verify it is gone by 
entering SHOW INTRUSION/TYPE=ALL. 


$ SHOW INTRUSION/TYPE=INTRUDER 

Find the record with your user name as the SOURCE. 

$ DELETE/INTRUSION UPRIVn 

Now try to get in through that source (that is, network, remote, local, and so on). 
Did it work? Why or why not? 


Yes, it did work. You are no longer an INTRUDER. The intruder record is gone. 
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Laboratory Exercise 8-4 — Alternate SYSUAF (Optional) 


1. Your instructor will create an alternate copy of the SYS$SYSTEM:SYSUAF.DAT file and will 
modify your account in the new file. The alternate copy is SYS$SYSTEM:SYSUAFALT.DAT. 
Start the system conversationally, specifying the alternate UAF file. Log in and enter the 
SHOW PROCESS command to verify that the alternate file was used. The display should 
contain the new values entered by your instructor. Check with your instructor to verify this. 


2. Your instructor will shut the system down for you. Start it conversationally, specifying the 
normal SYS$SYSTEM:SYSUAF.DAT file as the UAF file. Log in and enter the SHOW 
PROCESS command. The display should look normal. 
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Solutions to Laboratory Exercise 8-4 — Alternate SYSUAF (Optional) 


1. Boot the system conversationally. Enter the commands SET UAFALTERNATE 1 and 
CONTINUE at the SYSBOOT> prompt. 


2. Boot the system conversationally. Enter the commands SET UAFALTERNATE 0 and 
CONTINUE at the SYSBOOT> prompt. 
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LABORATORY EXERCISES — ee A 
NETWORK NODE 


Laboratory Exercise 9-1 — NCP Utility 


Your instructor will provide you with a node name and address to use for this exercise. 


At an interactive terminal, perform the following tasks: 


1. 


Try to use the SET HOST command to connect to the node whose name you were given. 
What happens? 


Run NCP and enter commands to find out whether that node is registered in both the 
permanent and volatile remote node databases. 


Define the node in the permanent database. 
Exit from NCP and try step 1 again. What happens and why? 


Run NCP again and enter a command to copy the node name and address from the 
permanent to the volatile database. 


Exit from NCP and try step 1 again. What happens and why? 


Run NCP and remove the node entry from both databases. 
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Solutions to Laboratory Exercise 9-1 — NCP Utility 


These solutions illustrate the use of node name SHIRT and address 5.123. Substitute the name 
and address that your instructor gave you. 


1. 


You see this message: 


%SYSTEM-F-NOSUCHNODE, remote node is unknown 


If the node is in neither database, you see this output: 


$ RUN SYSSSYSTEM:NCP 
NCP> LIST NODE SHIRT 


Node Volatile Summary as of 15-SEP-1991 10:53:28 
SNCP-W-UNRCMP, Unrecognized component , Node 
NCP> SHOW NODE SHIRT 


Node Volatile Summary as of 15-SEP-1991 10:53:28 
SNCP-W-UNRCMP, Unrecognized component , Node 


NCP> DEFINE NODE SHIRT ADDRESS 5.123 


or 


NCP> DEFINE NODE 5.123 NAME SHIRT 


NoP> 


$ SET HOST SHIRT 
SSYSTEM-F-NOSUCHNODE, remote node is unknown 


The node is still not defined in the volatile database, and the volatile database is where the 
DECnet software gets its data during operation. 
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$ RUN SYSSSYSTEM: NCP 
NCP> SET NODE SHIRT ALL 


or 


S$ RUN SYSSSYSTEM: NCP 
NCP> SET NODE 5.123 ALL 


or 


$ RUN SYSSSYSTEM: NCP 
NCP> SET NODE SHIRT ADDRESS 5.123 


or 


$ RUN SYSSSYSTEM:NCP 
NCP> SET NODE 5.123 NAME SHIRT 


6. If the node exists and is running, you see the login prompt. If it does not exist or is not 


running, you see the following message: 


SSYSTEM-F-UNREACHABLE, remote node is not currently reachable 


NCP>CLEAR NODE SHIRT ALL 
NCP>PURGE NODE SHIRT ALL 


or 


NCP>CLEAR NODE 5.123 ALL 
NCP>PURGE NODE 5.123 ALL 
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Laboratory Exercises 13-65 


Laboratory Exercise 9-2 — NCP in a VAXcluster System 
1. Find out whether the executor database is in the node-specific or cluster-common directory. 
Where is it and why? 


2. Find out whether the remote node database is in the node-specific or cluster-common 
directory. Where is it and why? 


3. If the remote node database is in the cluster-common directory, continue with this exercise. 


Using the same node name and address you were given in Exercise 9-1, add the node to 
both the permanent and the volatile databases. 


4. Use either the TELL or SET EXECUTOR command to set the executor node to another 
node in the same cluster. Find out whether the node you added appears in the permanent 
and volatile databases. 


5. Still using that other node as the executor, copy the node entry from the permanent to the 
volatile database. 
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Solutions to Laboratory Exercise 9-2 — NCP in a VAXcluster System 


1. Enter these commands: 


$ DIRECTORY SYSSSPECIFIC: [SYSEXE]NETNODE_ LOCAL.DAT 
$ DIRECTORY SYSSCOMMON: [SYSEXE]NETNODE_LOCAL.DAT 


The executor database should be in SYS$SPECIFIC:[SYSEXE]. It contains the local node’s 
name and address, which must be unique within the network; therefore, each node must 
have a private copy of the executor database. 


2. Enter these commands: 


S$ DIRECTORY SYSSSPECIFIC: [SYSEXE]NETNODE_LOCAL.DAT 
$ DIRECTORY SYSSCOMMON: [SYSEXE]NETNODE LOCAL.DAT 


On many systems, the remote node database is in SYS$COMMON:[SYSEXE]. It takes less 
effort to maintain a single remote node database than to maintain a copy for each node in 
the cluster, since in most cases they all need to contain the same list of nodes. 


$ RUN SYSSSYSTEM: NCP 
NCP> DEFINE NODE SHIRT ADDRESS 5.123 
NCP> SET NODE SHIRT ALL 


or equivalent commands (see Exercise 9-1). 
4. Substitute the name of the other node for JACKET in this example. You probably need to 


use access control to perform this operation. 


NCP> SET EXECUTOR JACKET"username password" 
NCP> LIST NODE SHIRT 


Node Permanent Summary as of 15-SEP-1991 11:18:58 
Remote node = 5.123 (SHIRT) 


No information available 


NCP>SHOW NODE SHIRT 
Node Volatile Summary as of 15-SEP-1991 11:19:03 


%NCP-W-UNRCMP, Unrecognized component , Node 


The output indicates that it is in the permanent but not the volatile database. 
NCP> SET NODE SHIRT ALL 


or 


NCP> SET NODE 5.123 ALL. 
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LABORATORY EXERCISES — SYSTEM MONITORING 
Laboratory Exercise 10-1 — MONITOR Utility 


10. 


11. 


12. 
13. 


Using a video terminal, run the MONITOR utility to display the MONITOR> prompt. At the 
prompt, enter a command to the utility to display the PAGE class with an update interval of 
ten seconds. Allow the utility to run for five to ten minutes. Watch the display and notice 

how (if you are on an active system) the display changes with time. 


Return to the MONITOR> prompt and display the SYSTEM class. 
Return to the MONITOR> prompt and display the I/O class. 


Use MONITOR to create a file called SUMMARY.DAT that contains summary information 
about the PROCESSES class. Allow the utility to write several screens of information to 
the file before you enter the CTRL/Z key sequence to return to the DCL prompt. (Each time 
the values in the display change, the utility writes a copy of the display to the file.) Display 
the file on your terminal screen after you exit from the utility. 


issue the command to monitor the cluster. This may take a while to build a display because 
a network process must be created on each node. 


Issue the DCL command to display the cluster information once, then return to the DCL 
prompt. Select one other node name to be used for the next step. 


Monitor your system plus the other selected node. 


Have a lab partner monitor your node, then pause by returning to the MONITOR prompt. 
While their MONITOR display is alternately active and inactive, issue the DCL command to 
find out the priorities of this created process. Note the process name/priority as opposed 
to the PID. 


Return to the MONITOR> prompt and display any other classes that you want. Use the 
HELP facility in the MONITOR utility to list the names of the classes and possible qualifiers. 


Use the SHOW USERS command to obtain a list of the interactive users on the system. 
Use the SHOW SYSTEM command to obtain a list of the processes on the system. 
Compare the names of the interactive users with the list of process names. Note which 
processes appear in one but not the other. 


Use the SHOW PROCESS/CONTINUOUS command to examine your own process. What 
image does the program indicate you are running? Try the V key, (get help). 


Which DCL command gives you information on physical memory and usage? 


Which DCL command gives you information on the page files and swap files and their 
usage? 
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Solutions to Laboratory Exercise 10-1 — MONITOR Utility 


is 


$ MONITOR 
MONITOR> MONITOR PAGE 


MONITOR> MONITOR SYSTEM 


MONITOR> MONITOR IO 


MONITOR> MONITOR PROCESS/SUMMARY=SUMMARY . DAT 


$ TYPE SUMMARY.DAT 
MONITOR> MONITOR CLUSTER 


CTRL/Z 
$ SHOW CLUSTER 


$ MONITOR CLUSTER/NODE= (yours, selected_other) 


...as the MONITOR CLUSTER process begins 
$ SHOW SYSTEM/NETWORK 
VAX/VMS V5.3-2 on node WIZARD 27-JUN-1991 13:03:04.10 Uptime 26 12:12:38 


Pid Process Name State Pri I/O CPU Page flts Ph.Mem 
20209704 FAL 25005 LEF 6 6675 0 00:00:13.64 1466 287 N 
2020D090 SERVER_00O4A LEF 6 4394 0 00:00:28.65 13648 304 N 
2020C939 AFP _FIRLAND LEF 6 2379 0 00:00:11.40 577 789 N 
2020A0C9 FAL 8457 LEF 6 4140 0 00:00:08.86 1578 289 N 
202077CE FAL 324 LEF 6 2906 0 00:00:09.17 819 332 N 
2020CED4 VPM_24906 LEF 5 26 0 00:00:00.22 166 244 WN 


13-70 Laboratory Exercises System Monitoring — Chapter 10 


..after the MONITOR CLUSTER process starts collecting data 
$ SHOW SYSTEM/NETWORK 
VAX/VMS V5.3-2 on node WIZARD 27-JUN-1991 13:09:30.12 Uptime 26 12:19:04 


Pid Process Name State Pri I/O CPU Page flts Ph.Mem 
20209704 FAL 25005 LEF 6 6675 0 00:00:13.64 1466 287 N 
2020D090 SERVER _OO4A LEF 6 4518 0 00:00:29.81 14582 300 N 
2020C939 AFP FIRLAND LEF 6 2391 0 00:00:11.49 577 789 N 
2020A0C9 FAL 8457 LEF 6 4140 0 00:00:08.87 1578 289 N 
202077CE FAL 324 LEF 6 2906 0 00:00:09.17 819 332 N 
2020CED4 MONITOR_SERVER HIB 15 196 0: 00::00301.52 781 338 N 

...after the MONITOR CLUSTER process is interrupted by a 
$ SHOW SYSTEM/NETWORK 
VAX/VMS V5.3-2 on node WIZARD 27-JUN-1991 13:09:01.04 Uptime 26 12:18:35 

Pid Process Name State Pri I/O CPU Page flts Ph.Mem 
20209704 FAL 25005 LEF 6 6675 0 00:00:13.64 1466 287 N 
2020D090 SERVER_OO4A LEF 6 4518 0 00:00:29.81 14582 300 N 
20200939 AFP _FIRLAND LEF 6 2390 0 00:00:11.49 577 789 N 
2020A0C9 FAL 8457 LEF 6 4140 0 00:00:08.87 1578 289 N 
202077CE FAL 324 LEF 6 2906 0 00:00:09.17 819 332; °N 
2020CED4 SERVER_0006 LEF 4 181 0 00:00:01.39 643 336 N 

...after the MONITOR utility is terminated 
$ SHOW SYSTEM/NETWORK 
VAX/VMS V5.3-2 on node WIZARD 27-JUN-1991 13:20:34.38 Uptime 26 12:30:08 

Pid Process Name State Pri I/O CPU Page flts Ph.Mem 
20209704 FAL 25005 LEF 6 6675 0 00:00:13.64 1466 287 N 
2020D090 SERVER_OO4A LEF 4 5004 0 00:00:33.94 17038 283 N 
2020C939 AFP FIRLAND LEF 6 2412 0 00:00:11.50 577 789 N 
2020A0C9 FAL 8457 LEF 6 4144 0 00:00:08.87 1578 289 N 
202077CE FAL 324 LEF 6 2906 0 00:00:09.17 819 332 N 


9. Enter the CTRL/C key sequence to cancel any display and return to the MONITOR> 
prompt. 


$ MONITOR 
MONITOR> HELP MONITOR 


10. There should be more processes listed by SHOW SYSTEM than by SHOW USERS. 
SHOW SYSTEM lists the system processes, interactive processes, processes from batch 
queues, and subprocesses. SHOW USERS lists interactive users attached to terminals. 


11. SHOW PROCESS/CONTINUOUS shows that you are executing the image 
SYS$SYSROOT:[SYSEXE]SHOW.EXE. 


12. 


S SHOW MEMORY /PHYSICAL 


13. 


S SHOW MEMORY/FILES/FULL 
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LABORATORY EXERCISES — DEVELOPING 
COMMAND PROCEDURES 

Laboratory Exercise 11-1 — Adding a User 

Write a simple command procedure to add a user to the system. 
The procedure should prompt for: 

* User name 

¢ Full name 

* Password 

¢« UIC group and member number 

* Account name 

¢ Login directory and device 


¢ Disk quota and overdraft 


Using the values provided by the user, the procedure should: 
¢ Add a record to the UAF for the user 

¢ Display the information in the new record 

¢ Add a disk quota entry for the user 


* Create a directory owned by the user 


Hint 


Some utilities, including AUTHORIZE and SYSMAN, allow you to execute a single utility 
command as a DCL command line. First, define a symbol that runs the utility, using this special 
format (called a foreign commana): 


$ AUTHORIZE := SAUTHORIZE 
S$ SYSMAN := SSYSMAN 


Then place the utility command after the symbol name on a command line in order to execute 
the command, for example: 


S$ AUTHORIZE SHOW username 

$ AUTHORIZE ADD username /PASSWORD=password /OWNER="owner" 
$ SYSMAN DISKQUOTA SHOW username 

S$ SYSMAN DISKQUOTA ADD username /PERMQUOTA=blocks 


After the command executes, control returns to DCL rather than remaining in the utility. 
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Solution to Laboratory Exercise 11-1 — Adding a User 


SU RKKKKKKKKKKKKKKKKKK 


$'* Comment Section * 
$! KEKKEKAKKKEKKKKKKKEKE 


$! ADDUSER.COM 


$! 

$! This procedure assists you in adding a user to the system. It adds 
$! the record to AUTHORIZE, adds a DISKQUOTA record, and 

$! creates a directory. 

$! For the sake of clarity, no extensive error checking is performed 
$! and no defaults are supplied for the user input. 

$! 


SUKKKKKKKKKREKKKKRKKKKKKKKKKK KK 


$!* Initialization Section * 
SUE RRR KKK KK KKK KREKKKKK KKK KKK 


$! 

$ AUTHORIZE = "SAUTHORIZE" 
$ SYSMAN = "SSYSMAN" 

$! 


SURKKKKKKKKKKKKKEKE 


S$t* Main Section * 
SUERKKKKKKKKKKKKKKK 


$! 
$! Request Account Information 
$! 
S$ READ SYSSCOMMAND /PROMPT= "Username : “ USERNAME 
S$ READ SYSSCOMMAND /PROMPT= "Full Name : " FULLNAME 
S$ READ SYSSCOMMAND /PROMPT= "Password : " PASSWORD 
$! 
$ Get UIC 
$! 
S$ READ SYSSCOMMAND /PROMPT= "Group UIC (number or an *) : " GROUP 
$ READ SYSSCOMMAND /PROMPT= "Member number : " MEMBER 
$ UIC = "[" + GROUP + "," + MEMBER + "]" 
S READ SYSSCOMMAND /PROMPT= "Account Name : " ACCOUNT 
S$ READ SYSSCOMMAND /PROMPT= "Login Directory (use brackets) : " DIR 
$ READ SYSSCOMMAND /PROMPT= "Login Device (use colon) : " DEVICE 
$! 
$ AUTHORIZE ADD ‘USERNAME’ /OWNER="''’FULLNAME’" - 
/ACCOUNT="" ‘ACCOUNT’" /PASSWORD=’ PASSWORD’ /DEVICE=' DEVICE’ - 
/DIRECTORY='DIR’ /UIC='UIC’ 
$! 


$ WRITE SYSSOUTPUT "This is the user you added." 
$ AUTHORIZE SHOW ’ USERNAME’ 


$! 
$ READ SYSSCOMMAND /PROMPT= "Disk Quota : " DISK QUOTA 
$ READ SYSSCOMMAND /PROMPT= "Disk Overdraft : " OVERDRAFT 


$ SYSMAN DISKQUOTA ADD ‘UIC’ - 
/PERM=' DISK_QUOTA’ /OVERDRAFT=' OVERDRAFT’ /DEVICE=' DEVICE’ 
$! 
$ ADD_DIRECTORY: 
$! 
$ CREATE /DIRECTORY /OWNER='UIC’ ‘’DEVICE’’DIR’ /LOG 
$ EXIT 
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Laboratory Exercise 11-2 — Generating Accounting Reports 


1. Write a short command procedure that generates an accounting report. The procedure 
should run at midnight every night and report on the previous day’s activity. 


The report should summarize for each user: 


Pages printed 
Processor time 
Peak physical memory usage (working set) 


Direct I/O operations 


The procedure should then mail the report to the SYSTEM account and then delete the 
report. 


2. Modify the procedure so that on Mondays it performs one additional task: it should close 
the current accounting file and open a new one. 


Also, if it does not already do so, it should put the day of the week in the subject heading 
of the mail message. 


Hints 


The MAIL command takes two parameters (file specification and recipient name), and has a 
qualifier by which you can specify the subject of a message. See the documentation or on-line 
help for examples of the use of these parameters and qualifier. 


To determine the day of the week, your procedure needs to use the F§CVTIME lexical function. 
Use the documentation or on-line help to find examples of the usage of FSCVTIME. 
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Solutions to Laboratory Exercise 11-2 — Generating Accounting 
Reports 


1. 
$!ACCOUNTING REPORT .COM 
$! 
$! This procedure generates a nightly accounting report and mails 
$! it to the system manager’s account. 
$! 
$ ACCOUNTING /SUMMARY=USER /REPORT= (PROCESSOR, WORKING SET, DIRECT IO) - 
/SINCE=YESTERDAY /OUTPUT=NIGHTLY_ REPORT.LIS 
$ MAIL NIGHTLY _REPORT.LIS SYSTEM /SUBJECT="Nightly accounting report” 
$ DELETE NIGHTLY REPORT.LIS 
$ SUBMIT /AFTER=TOMORROW SYSSMANAGER:ACCOUNTING REPORT .COM 
2. 


$!ACCOUNTING REPORT .COM 

$! 

$! This procedure generates a nightly accounting report and mails 
$! it to the system manager’s account. 


$! 

$! It also closes the accounting file every Monday and opens a new one. 
$! 

$ DAY = FSCVTIME(,,"WEEKDAY") 


$ ACCOUNTING /SUMMARY=USER /REPORT= (PROCESSOR, WORKING SET, DIRECT IO) - 
/SINCE=YESTERDAY /OUTPUT=NIGHTLY REPORT.LIS 

$ IF DAY .EQS. "Monday" THEN SET ACCOUNTING /NEW_FILE 

$ MAIL NIGHTLY REPORT.LIS SYSTEM /SUBJECT="Nightly accounting report for ‘’’DAY’" 

S$ DELETE NIGHTLY REPORT.LIS 

$ SUBMIT /AFTER=TOMORROW SYSSMANAGER:ACCOUNTING REPORT.COM 
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Laboratory Exercise 11-3 — Writing a Backup Procedure 


Write a command procedure that resubmits itself to run every night at midnight. It backs up 
disk $1$DUA1 to tape drive $1$MUAO. 


lt should perform an incremental backup unless it is Wednesday, in which case it should perform 
a full backup. | 


Define the disk and tape device names as symbols near the beginning of your procedure, so 
that you could easily change them. 
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Solution to Laboratory Exercise 11-3 — Writing a Backup Procedure 


$!Comment Section 
$! 
$! BACKUP . COM 
$! This procedure assists the operator in 
$! performing incremental and full backups 
$! ASSUMPTION: 
$! The assumption is that FULL backups are done 
$! on Wednesday. The procedure tests for the day 
$! of the week and acts accordingly. 
$! 
$!Initialization Section 
$! 
$! 
$ DISK "S1SDUA1:" 
$ TAPE = "MUAO:" 
a) 
$!Main Section 
$! 
$ DAY = FSCVTIME(,,"WEEKDAY") 
$ IF DAY .EQS. "Wednesday" THEN 
$! 
$! Do full backup 
$! 
$ ALLOCATE MUAO: 
$ INITIALIZE MUAO: FULLBK 
$ BACKUP /REWIND /RECORD /DENSITY=1600 /BLOCK=32784 - 
/IMAGE 'DISK’ MUAO:FULLBK.BCK 
$ WRITE SYSSOUTPUT - 
" THE FULL BACKUP OF ‘’DISK’ IS COMPLETE" 
$ DISMOUNT/NOUNLOAD MUAO: 


$! 

$ ELSE 

S$! 

$! Do incremental backup 
$! 


$ ALLOCATE MUAO: 
$ INITIALIZE MUAO: INCRBK 
$ BACKUP /REWIND /RECORD /IGNORE=INTERLOCK - 

/MODIFIED /SINCE=BACKUP ‘DISK’ [*...]*.*;* MUAO: INCRBK.BCK 
$ WRITE SYSSOUTPUT - 

" THE INCREMENTAL BACKUP OF ‘’’DISK’ IS COMPLETE" 

$ DISMOUNT/NOUNLOAD MUAO: 
$ ENDIF 
$! 
$ SUBMIT /AFTER=TOMORROW SYSSMANAGER: BACKUP .COM 
$! 
$ EXIT 
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Test 


QUESTIONS 


Write the letter of the best answer in the space next to each of the following questions. 


1. Suppose you create a user directory $1$DIA200:[NEILSEN] and forget to specify 
that user NEILSEN should own it. What command would you use to correct the ownership 
of the directory? 





a. SET FILE /OWNER=NEILSEN $1$DIA200:[NEILSEN] 

b. SET FILE /OWNER=NEILSEN $1$DIA200:[O00000]NEILSEN.DIR 

c. SET FILE /BY_OWNER=NEILSEN $1$DIA200:[(O00000JNEILSEN.DIR 
d. SET FILE /BY_OWNER=NEILSEN $1$DIA200:NEILSEN 


2. Which BACKUP command qualifier is used to list the contents of a save set on 
tape? 


a. /LIST 

b. /SELECT 

c. /SINCE 

d. /SAVE_SET 


3. What command procedure automates the procedure for registering or amending a 
license? 


a. SYS$UPDATE:VMSINSTAL.COM 
b. SYS$UPDATE:VMSLICENSE.COM 
c. SYS$SYSTEM:AUTHORIZE.COM 
d. SYS$UPDATE:AUTOGEN.COM 
4. _____Whenddo you usually need to install a product's license key? 
a. After you install the product software 
b. Before you install the product software 
c. Before you read the product documentation 


d. After users begin to use the product 
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5. 


8. 


A user mistypes his password five times. Thereafter, because of break-in detection, 
he cannot log in even if he types the correct password. What command can help you 
enable him to log in again? 

a. DELETE /INTRUSION RECORD 

b. SET TERMINAL /SECURE_SERVER 

c. SET PASSWORD /SYSTEM 

d. MONITOR /SYSTEM 

You create an image backup of a disk on Wednesday, on a tape labeled WED. 


You make incremental backups on Thursday on a tape labeled THU, on Friday on a tape 
labeled FRI, and on Monday on a tape labeled MON. 





On Tuesday afternoon the disk fails. After it is replaced, you want to restore it to the most 
recent possible state; in what order should you restore the backup tapes? 


a. THU, then FRI, then MON, then WED 

b. MON, then FRI, then THU, then WED 

c. WED, then THU, then FRI, then MON 

d. WED, then MON, then FRI, then THU 

_____What BACKUP qualifiers are necessary to achieve incremental backups? 
a. /IMAGE, /INCREMENTAL 

b. /REWIND, /SINCE 

Cc. ANITIALIZE, /RECORD 

d. /RECORD, /SINCE 


A user complains that an application does not work, and the error message is 
"RMS-E-FLK, file currently locked by another user" (in other words, the file is open and 
cannot be opened by two processes at once). What command would help you find out 
what other process has the file locked? 

a. SHOW DEVICE /FULL device-name 
b. DIRECTORY /FULL file-spec 
c. SHOW DEVICE /FILES device-name 


d. DIRECTORY /OPEN file-spec 
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9. Using the Authorize utility, which flag would you set to restrict an account to a 
specific login command procedure? 
a. CAPTIVE 
b. DEFCLI 
c. DISCTLY 
d. LOCKPWD 
10. | | What command displays all the logical names in the group table for your UIC group? 
a. SHOW LOGICAL /UIC 
b. SHOW LOGICAL /TABLE=GROUP 
c. SHOW LOGICAL /GROUP 
d. SHOW LOGICAL /SYSTEM 


11. Several commands and qualifiers are available for monitoring print queues and jobs. For 
each of the functions below, select the command and qualifier that best implements that 
function and write its letter in the space provided. Each selection can be used once, more 
than once, or not at all. 


Function Command/Qualifier 

List all the queues on the a. SHOW ENTRY 

system 

List the print jobs that b. SHOW ENTRY /FULL entry-number 
belong to a particular 

user 


List the print and batch c. SHOW ENTRY /DEVICE /USER_NAME=user-name 
jobs that belong to you 

List all the entries in d. SHOW QUEUE 

all the queues on the 

system 

Find out the job limitona e. SHOW QUEUE /FULL queue-name 
particular queue 

Find out what file is being f. SHOW QUEUE /ALL 

printed in a particular 

entry 

Find out what time a 

job was submitted for 

printing 
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12. Many DCL features are useful in writing command procedures. For each of the functions 
below, select the command or qualifier that best implements that function and write its letter 
in the space provided. Each selection can be used once, more than once, or not at all. 


13. 





Function Command/Qualifier 


Putting the results of the START/QUEUE a. DEFINE 
command in a file 


Putting the results of a DIRECTORY b. /OUTPUT=filename 
command in a file 

Displaying the content of a symbol at a c. TYPE symbol 
terminal 

Sending a copy of a file to the SYSTEM d. MAIL 

account 


Putting the results of the ACCOUNTING e. WRITE symboL 
command into a file 


Asking the user whether he or she wants f. INQUIRE 
to see some information (Y/N) 


Displaying information that has been 
obtained from the user 


If you wanted to know the amount of free space and total space on a disk volume, 


which command would you use? 


a. 


b. 


14. 


a. 
b. 


Cc. 


SHOW VOLUME 
SHOW QUOTA 
SHOW DEVICE/FULL 
SHOW ALL 


As a system manager, you would use disk quota rebuild for what purpose? 


To reconstruct the usage counts for all entries on the volume 
To reenable disk quotas on the volume after system failure 


To rebuild the disk quota file after the disk volume was improperly dismounted 
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15. _A process that controls individual printers on a VMS system is called: 
a. A job controller 
b. A print symbiont 
c. A cluster server 
d. An ancillary control process (ACP) 
16. |= | What SYSMAN command is used to create a disk quota file on a volume? 
a. DISKQUOTA CREATE 
b. DISKQUOTA REBUILD 
c. CREATE DISKQUOTA 
d. VOLUME CREATE 
17. ____ Which of the following NCP commands manipulates the volatile database? 
a. PURGE 
b. DEFINE 
c. LIST 
d. CLEAR 


18. Which of the following commands creates a new entry in the permanent network 
database? 


a. SET NODE ROGER ADDRESS 2.4 

b. SET NODE 2.4 NAME ROGER 

c. DEFINE NODE 2.4 NAME ROGER 

d. DEFINE ADDRESS 2.4 NAME ROGER 
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19. 





If you want to ask node MASTER what the address of node FIRST is, what NCP 


command could you use? 


a. 
b. 
Cc. 


d. 


20. 


NT 


1. 


2 
3 
4. 
5 
6 


SET HOST MASTER 

TELL MASTER SHOW NODE FIRST 

TELL MASTER SET EXECUTOR FIRST 

SET EXECUTOR NODE FIRST 

Suppose you perform the following actions: 

Boot the cluster nodes BARNUM and RNGLNG, which are connected to the Cl bus. 
Install a new disk drive, named $1$DUA33:, on the HSC unit. 

Initialize $1$DUA33:. 

Enter the MOUNT/CLUSTER command on BARNUM to mount $1$DUA33:. 

Boot the node BAILEY, which is also connected to the Cl bus. 


Boot the node HORSE, which is a satellite. 


Which nodes have $1$DUA33: mounted after this sequence of actions? 


a. 
b. 


Cc. 


21. 


BARNUM 

BARNUM, RNGLNG 

BARNUM, RNGLNG, BAILEY 
BARNUM, RNGLNG, BAILEY, HORSE 


In a command procedure, parameters P1 through P8 are available for use as: 


Logical names 
DCL symbols 
Character strings 


File specifications 
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22. 


23. 


24. 


____In acommand procedure, you can obtain the current system time by means of: 
a. A predefined symbol 

b. A logical name 

c. A lexical function 

d. A parameter 


On the line next to each expression below, write the value (0 or 1) of the expression. 
Assume that: 


¢ DAY is asymbol containing the string "Tuesday" 
« TUESDAY is a symbol containing the integer 3 


¢ VALUE is a symbol containing the integer 53 


a. ___ DAY .EQS. "TUESDAY" 

b. _— DAY .EQS. TUESDAY 

c. ___—~VALUE .GT. TUESDAY 

d. 53. .EQ. VALUE 

e. __—C+DAY .EQSS. "Tuesday" 

f. — "THURSDAY" .GTS. "TUESDAY" 
g. ___ VALUE .LE. 0 

h. ____ TUESDAY .GT. 7 


If the symbol VALUE contains the integer 5 on entry to the following DCL code, what 
value does TOTAL have after the code has executed? . 





$ IF VALUE .GT. 2 


$ THEN 

$ TOTAL = VALUE 

$ TOTAL = TOTAL + 5 
$ ELSE TOTAL = VALUE + 3 
$ ENDIF 

a. 4 

b. 5 

c. 6 

d. 7 
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25. 


Which logical name table is available to all processes and subprocesses on a 


system? 


a 
b. 
Cc. 


d. 


26. 





LNM$PROCESS 
LNM$JOB 
LNM$GROUP 
LNM$SYSTEM 


Which of the following command statements will substitute a device’s logical name 


(for example, GEORGE) for its physical name (for example, DUAO) in system message 
displays? 


a. 
b. 
Cc. 


d. 


27. 


DEFINE GEORGE DUAO: 
DEFINE/TRANSLATION_ATTRIBUTES=CONCEALED GEORGE DUAO: 
DEFINE/TRANSLATION_ATTRIBUTES=TERMINAL GEORGE DUAO: 
ASSIGN/TRANSLATION_ATTRIBUTES=TERMINAL GEORGE DUAO: 


Which of the following would you use to cause the VMS system to record events 


such as process deletion, print job completion, login failure, and batch job completion? 


a 
b. 
c. 


d. 


28. 





SET ACCOUNTING 

SET ACCOUNTING/RECORD 
ACCOUNTING 
ACCOUNTING/RECORD 


Which of the following should be used to upgrade or update system layered product 


software? 


SYS$UPDATE 
VMSINSTAL 
SYSGEN 
INSTALL 
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29. Which of the following commands displays (on one screen) several of the most 
important classes of information a system manager can monitor? 





a. MONITOR PROCESSES /TOPCPU 
b. MONITOR STATES 

c. MONITOR SYSTEM 

d. MONITOR ALL_CLASSES 


30. What DCL command most quickly shows you which nodes are currently members of 
the cluster? 





a. SHOW CLUSTER 
b. SHOW MEMBERS 
c. MONITOR NODES 
d. MONITOR CLUSTER 
31. || What DCL command most easily shows you what program a process is running? 
a. SHOW IMAGE 
b. SHOW USERS 
c. MONITOR PROCESSES 
d. SHOW PROCESS/CONTINUOUS 
32. | What DCL command do you use to find out whether the DECnet software is running? 
a. SHOW DECNET 
b. MONITOR CLUSTER 
c. SHOW NETWORK 
d. SHOW PROCESS 
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33. 


A disk device is connected to cluster node DD, which has allocation class 44. The 





device has unit number 33 and device type DU. Which of the following is a valid name for 
the device? 


a. 
b. 
c. 


d. 


34. 


a 
b. 


Cc. 


35. 


Cc. 


d. 


36. 


a. 
b. 


Cc. 


$DD$DUA44 

$44$DDA33 

$33$DUA44 

$44$DUA33 

Which of the following control break-in detection? 
Symbols 

Identifiers 

Logical names 


System parameters 


What file do you edit to make parameter changes permanently known to AUTOGEN? 


SYS$MANAGER:VMSIMAGES.DAT 
SYS$UPDATE:AUTOGEN.DAT 
SYS$SYSTEM:SETPARAMS.DAT 
SYS$SYSTEM:MODPARAMS.DAT 

Which DCL command is used to create a queue? 
INITIALIZE/QUEUE 

CREATE/QUEUE 

START/QUEUE 

ASSIGN/QUEUE 
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37. In which file are terminal speeds, queues, and other system management related 
operations usually specified? 





a. SYLOGIN.COM 
b. SYSTARTUP_V5.COM 
c. STARTUP.COM 
d. SYLOGICALS.COM 
38. _ Which procedure should mount site-specific volumes? 
a. SYSTARTUP_V5.COM 
b. STARTUP.COM 
c. SYLOGICALS.COM 
d. SYCONFIG.COM 


39. Which procedure should define standard logical names such as SYS$LOGIN, 
SYS$ANNOUNCE, and SYS$WELCOME? 


a. SYLOGICALS.COM 
b. SYCONFIG.COM 
c. SYSTARTUP_V5.COM 
d. STARTUP.COM 
40. __In which table are shareable logical name tables cataloged? 
a. LNM$SYSTEM_TABLE 
b. LNM$GROUP 
c. LNM$JOB 
d. LNM$PROCESS_TABLE 
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41. Before an active queue can be deleted, it must first be: 


a. Initialized 
b. Stopped 
c. Spooled 
d. Started 
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ANSWERS 


iP 


4. 


b Suppose you create a user directory $1$DIA200:[NEILSEN] and forget to specify 
that user NEILSEN should own it. What command would you use to correct the ownership 
of the directory? 





a. SET FILE /OWNER=NEILSEN $1$DIA200:[NEILSEN] 

b. SET FILE /OWNER=NEILSEN $1$DIA200:[O00000JNEILSEN.DIR 

c. SET FILE /BY_OWNER=NEILSEN $1$DIA200:[O00000]NEILSEN.DIR 
d. SET FILE /BY_OWNER=NEILSEN $1$DIA200:NEILSEN 


a Which BACKUP command qualifier is used to list the contents of a save set on 
tape? 


a. /LIST 

b. /SELECT 

c. /SINCE 

d. /SAVE_SET 


b What command procedure automates the procedure for registering or amending a 
license? 


a. SYS$UPDATE:VMSINSTAL.COM 

b. SYS$UPDATE:VMSLICENSE.COM 

c. SYS$SYSTEM:AUTHORIZE.COM 

d. SYS$UPDATE:AUTOGEN.COM 

__b When do you usually need to install a product's license key? 
After you install the product software 


a 
b. Before you install the product software 


© 


Before you read the product documentation 


d. After users begin to use the product 
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t. 


8. 


b . A user mistypes his password five times. Thereafter, because of break-in detection, 
he cannot log in even if he types the correct password. What command can help you 
enable him to log in again? 





a. DELETE /INTRUSION_ RECORD 
b. SET TERMINAL /SECURE_SERVER 
c. SET PASSWORD /SYSTEM 
d. MONITOR /SYSTEM 
d You create an image backup of a disk on Wednesday, on a tape labeled WED. 


You make incremental backups on Thursday on a tape labeled THU, on Friday on a tape 
labeled FRI, and on Monday on a tape labeled MON. 





On Tuesday afternoon the disk fails. After it is replaced, you want to restore it to the most 
recent possible state; in what order should you restore the backup tapes? 


a. THU, then FRI, then MON, then WED 

b. MON, then FRI, then THU, then WED 

c. WED, then THU, then FRI, then MON 

d. WED, then MON, then FRI, then THU 

__d_ What BACKUP qualifiers are necessary to achieve incremental backups? 
a. /IMAGE, /INCREMENTAL 

b. /REWIND, /SINCE 

c. /INITIALIZE, /RECORD 

d. /RECORD, /SINCE 


c A user complains that an application does not work, and the error message is 
"RMS-E-FLK, file currently locked by another user" (in other words, the file is open and 
cannot be opened by two processes at once). What command would help you find out 
what other process has the file locked? 

a. SHOW DEVICE /FULL device-name 
b. DIRECTORY /FULL file-spec 
c. SHOW DEVICE /FILES device-name 


d. DIRECTORY /OPEN file-spec 
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9. a Using the Authorize utility, which flag would you set to restrict an account to a 
specific login command procedure? 


a. CAPTIVE 
b. DEFCLI 

c. DISCTLY 
d. LOCKPWD 


10. —~c_ What command displays all the logical names in the group table for your UIC group? 
a. SHOW LOGICAL /UIC 
b. SHOW LOGICAL /TABLE=GROUP 
c. SHOW LOGICAL /GROUP 
d. SHOW LOGICAL /SYSTEM 


11. Several commands and qualifiers are available for monitoring print queues and jobs. For 
each of the functions below, select the command and qualifier that best implements that 
function and write its letter in the space provided. Each selection can be used once, more 
than once, or not at all. 


Function Command/Qualifier 


d List all the queues on the a. SHOW ENTRY 
system 
Cc List the print jobs that b. SHOW ENTRY /FULL entry-number 
belong to a particular 
_user 
a List the print and batch c. SHOW ENTRY /DEVICE /USER_NAME=user-name 
jobs that belong to you 
f List all the entries in d. SHOW QUEUE 
all the queues on the 
system 
e Find out the job limitona e. SHOW QUEUE /FULL queue-name 
particular queue 
b Find out what file is being f. SHOW QUEUE /ALL 
printed in a particular 
entry 
b Find out what time a 
job was submitted for 
printing 
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12. Many DCL features are useful in writing command procedures. For each of the functions 
below, select the command or qualifier that best implements that function and write its letter 
in the space provided. Each selection can be used once, more than once, or not at all. 











13. 


14. 


C 


a. 
b. 
c. 


d. 


ae 


Function 


Putting the results of the START/QUEUE 
command in a file 


Putting the results of a DIRECTORY 
command in a file 

Displaying the content of a symbol at a 
terminal 

Sending a copy of a file to the SYSTEM 
account 

Putting the results of the ACCOUNTING 
commanzd into a file 

Asking the user whether he or she wants 
to see some information (Y/N) 


Displaying information that has been 
obtained from the user 


Command/Qualifier 
a. DEFINE 


b. /OUTPUT=filename 
c. TYPE symbol 

d. MAIL 

e. WRITE symbol 


f. INQUIRE 


If you wanted to know the amount of free space and total space on a disk volume, 
which command would you use? 


SHOW VOLUME 
SHOW QUOTA 
SHOW DEVICE/FULL 
SHOW ALL 


As a system manager, you would use disk quota rebuild for what purpose? 


a. To reconstruct the usage counts for all entries on the volume 


b. To reenable disk quotas on the volume after system failure 


c. To rebuild the disk quota file after the disk volume was improperly dismounted 
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15. _b A process that controls individual printers on a VMS system is called: 
a. A job controller 
b. A print symbiont 
c. A cluster server 
d. An ancillary control process (ACP) 
16. —©a_ What SYSMAN command is used to create a disk quota file on a volume? 
a. DISKQUOTA CREATE 
b. DISKQUOTA REBUILD 
c. CREATE DISKQUOTA 
d. VOLUME CREATE 
17. _d_ Which of the following NCP commands manipulates the volatile database? 
a. PURGE 
b. DEFINE 
c. LIST 
d. CLEAR 


18. —c__ Which of the following commands creates a new entry in the permanent network 
database? 





a. SET NODE ROGER ADDRESS 2.4 

b. SET NODE 2.4 NAME ROGER 

c. DEFINE NODE 2.4 NAME ROGER 

d. DEFINE ADDRESS 2.4 NAME ROGER 
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19. b__ If you want to ask node MASTER what the address of node FIRST is, what NCP 
command could you use? 


a. SET HOST MASTER 
b. TELL MASTER SHOW NODE FIRST 
c. TELL MASTER SET EXECUTOR FIRST 
d. SET EXECUTOR NODE FIRST 
20. 6b Suppose you perform the following actions: 
1. Boot the cluster nodes BARNUM and RNGLNG, which are connected to the Cl bus. 
2. Install a new disk drive, named $1$DUA33:, on the HSC unit. 
3. Initialize $1$DUA33:. 
4. Enter the MOUNT/CLUSTER command on BARNUM to mount $1$DUA33:. 
5. Boot the node BAILEY, which is also connected to the Cl bus. 
6. Boot the node HORSE, which is a satellite. 
Which nodes have $1$DUA33: mounted after this sequence of actions? 
a. BARNUM 
b. BARNUM, RNGLNG 
c. BARNUM, RNGLNG, BAILEY 
d. BARNUM, RNGLNG, BAILEY, HORSE 
21. _b_ Inacommand procedure, parameters P1 through P8 are available for use as: 
a. Logical names 
b. DCL symbols 
c. Character strings 


d. File specifications 
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22. 


23. 


24. 


__¢_|Inacommand procedure, you can obtain the current system time by means of: 
a. A predefined symbol 

b. A logical name 

c. A lexical function 

d. A parameter 


On the line next to each expression below, write the value (0 or 1) of the expression. 
Assume that: 


¢« DAY is a symbol containing the string "Tuesday" 
« TUESDAY is a symbol containing the integer 3 

* VALUE is a symbol containing the integer 53 

a. 0 DAY .EQS. "TUESDAY" 


b. 0 DAY .EQS. TUESDAY 


Cc. 1 VALUE .GT. TUESDAY 


Te aneenanemnememned 


d. 1 53 .EQ. VALUE 


e. 1 DAY .EQS. "Tuesday" 


0 "THURSDAY" .GTS. "TUESDAY" 
g. 0 VALUE .LE.0 
h. 1 TUESDAY .GT.7 


c__lf the symbol VALUE contains the integer 5 on entry to the following DCL code, what 


value does TOTAL have after the code has executed? 


$ IF VALUE .GT. 2 


$ THEN 

$ TOTAL = VALUE 

$ TOTAL = TOTAL + 5 
$ ELSE TOTAL = VALUE + 3 
$ ENDIF 

a. 4 

b. 5 

c. 6 

d. 7 


Test 14-21 


25. _d_ Which logical name table is available to all processes and subprocesses on a 
system? 


a 
b. 
c. 


d. 


LNM$PROCESS 
LNM$JOB 
LNM$GROUP 
LNM$SYSTEM 


26. b Which of the following command statements will substitute a device’s logical name 
(for example, GEORGE) for its physical name (for example, DUAO) in system message 
displays? 


a. 
b. 
Cc. 


d. 


27. 





DEFINE GEORGE DUAO: 
DEFINE/TRANSLATION_ATTRIBUTES=CONCEALED GEORGE DUAO: 
DEFINE/TRANSLATION_ATTRIBUTES=TERMINAL GEORGE DUAO: 
ASSIGN/TRANSLATION_ATTRIBUTES=TERMINAL GEORGE DUAO: 


Which of the following would you use to cause the VMS system to record events 


such as process deletion, print job completion, login failure, and batch job completion? 


a. 
b. 
c. 


d. 


SET ACCOUNTING 

SET ACCOUNTING/RECORD 
ACCOUNTING 
ACCOUNTING/RECORD 


28. b Which of the following should be used to upgrade or update system layered product 
software? 


a. 


b. 


SYS$UPDATE 
VMSINSTAL 
SYSGEN 
INSTALL 
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29. 





Which of the following commands displays (on one screen) several of the most 


important classes of information a system manager can monitor? 


a. 
b. 
c. 
d. 
30. 





MONITOR PROCESSES /TOPCPU 
MONITOR STATES 

MONITOR SYSTEM 

MONITOR ALL_CLASSES 


What DCL command most quickly shows you which nodes are currently members of 


the cluster? 


a. 
b. 
Cc. 


d. 


SHOW CLUSTER 
SHOW MEMBERS 
MONITOR NODES 
MONITOR CLUSTER 


31. ©d What DCL command most easily shows you what program a process is running? 


a. 
b. 
Cc. 


d. 


SHOW IMAGE 

SHOW USERS 

MONITOR PROCESSES 

SHOW PROCESS/CONTINUOUS 


32. —c WhatDCLcommand do you use to find out whether the DECnet software is running? 


a. 
b. 
c. 


d. 


SHOW DECNET 
MONITOR CLUSTER 
SHOW NETWORK 
SHOW PROCESS 
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33. dA disk device is connected to cluster node DD, which has allocation class 44. The 
device has unit number 33 and device type DU. Which of the following is a valid name for 
the device? 





a. $DD$DUA44 
b. $44$DDA33 
c. $33$DUA44 
d. $44$DUA33 
34. _d_ Which of the following control break-in detection? 
a. Symbols 
b. Identifiers 
c. Logical names 
d. System parameters 
35. _d_ What file do you edit to make parameter changes permanently known to AUTOGEN? 
a. SYS$MANAGER:VMSIMAGES.DAT 
b. SYS$UPDATE:AUTOGEN.DAT 
c. SYS$SYSTEM:SETPARAMS.DAT 
d. SYS$SYSTEM:MODPARAMS.DAT 
36. — a Which DCL command is used to create a queue? 
a. INITIALIZE/QUEUE 
b. CREATE/QUEUE 
c. START/QUEUE 
d. ASSIGN/QUEUE 
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37. _b In which file are terminal speeds, queues, and other system management related 
operations usually specified? 





a. SYLOGIN.COM 
b. SYSTARTUP_V5.COM 
c. STARTUP.COM 
d. SYLOGICALS.COM 
38. _a__Which procedure should mount site-specific volumes? 
a. SYSTARTUP_V5.COM 
b. STARTUP.COM 
c. SYLOGICALS.COM 
d. SYCONFIG.COM 


39. a Which procedure should define standard logical names such as SYS$LOGIN, | 
SYS$ANNOUNCE, and SYS$WELCOME? 


a. SYLOGICALS.COM 
b. SYCONFIG.COM 
c. SYSTARTUP_V5.COM 
d. STARTUP.COM 
40. _b_ In which table are shareable logical name tables cataloged? 
a. LNM$SYSTEM_TABLE 
b. LNM$GROUP 
c. LNM$JOB 
d. LNM$PROCESS_TABLE 
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41. b_ Before an active queue can be deleted, it must first be: 


a. 


b. 


Initialized — 
Stopped 
Spooled 
Started 
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A 


ACCOUNTING command 
controlling I/O to ACCOUNTING.DAT file, 
7-4 
accounting record 
contents of, 7—4 
full format display (example), 7-4 
ACCOUNTING utility 
producing reports with, 7-8 
ACL (Access Control List) 
applying, 8-15 
benefits of, 8-27 
protection 
based on files (table), 8-23 
system protection procedures using, 
8-27 
Arithmetic expressions 
comparing, 11-24 
Arithmetic operations 
symbols, 11-21 
Arithmetic overlays 
definition, 11-59 
ASSIGN command 
qualifiers 
/MERGE, 3-32 
/NOLOG, 5-9 
autoconfiguration 
devices 
suppressing, 5-8 
AUTOCONFIGURE ALL command 
configuring devices with, 5-8 
AUTOGEN command 
phases of 
(table), 5-22 
reconfiguring system, 5-22 


Backup 
image 
restoring files from, 4-13 
batch execution queues 
function and limitations, 3-7 


Cc 


CALL command 
command procedures 
flow of execution, 11-43 
CLOSE command, 11-38 
CMKRNL (change mode to kernel) 
privilege 
permits 


INDEX 


CMKRNL (change mode to kernel) 
privilege . 
permits (cont'd) 
running of LICENSE, 6-12 
Command procedures 
error handling, 11-46 
file errors, 11-52 
ON, 11-48 
ON CONTROL_Y, 11-51 
SET NOCONTROL=Y, 11-51 
SET NOON, 11-50 
status check, 11-47 
flow of execution, 11-26 
CALL, 11-43 
GOSUB, 11-44 
GOTO, 11-29 
IF, 11-27 
guidelines, 11-5 
Pi through P8, 11-7 
parameters, 11-7 
steps in development, 11-5 
Command procedures 
format, 11-6 
Command processing 
phases, 11-56 
COPY command 
spooling, 3-9 


D 


DCL (Digital Command Language) 
commands 
monitoring the system (table), 10-28 
DECnet-VAX software 
starting 
SYSTARTUP_V5.COM function, 5-14 
DEFINE command 
qualifiers 
/NOLOG, 5-9 
/SYSTEM/EXECUTIVE, 5-9 
DELETE command 
qualifiers 
/QUEUVE, 3-33 
device code 
device names, 1-5 
device names 
format, 1-5 
devices 
characteristics 
setting, SYSTARTUP_V5.COM 
function, 5-14 
configuring 
with SYCONFIG.COM, 5-8 
connecting 
all standard, STARTUP.COM function, 
5-7 
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devices (cont'd) 
ownership required for queue creation, 
3-13 
special 
connecting, to the system, 5-8 
suppressing 
autoconfiguration of, 5-8 
dialup | 
lines 
as security risk, 8-6 
numbers 
security procedures, 8-7 
disk volume sets 
creating, 1-18 
creating from an existing volumes (example, 
1-18 
dump file 
specification and function 
(table), 5-19 


E 


EOA (erase-on-allocate) 
files 
as security, 8-7 
procedures, 8-9 
EOD (erase-on-delete) 
DCL commands and qualifiers 
(table), 8-9 
files 
as security, 8-7 
procedures, 8-9 
ERRFMT system process 
started up by STARTUP.COM, 5-7 
Error handling 
command procedures, 11-46 
file errors, 11-52 
ON, 11-48 
ON CONTROL_Y, 11-51 . 
SET NOCONTROLeY, 11-51 
SET NOON, 11-50 
status check, 11-47 
execution queues 
batch 
function and limitations, 3-7 
characteristics, 3-6 
creating 
for a printer (table), 3-16 
output 
function and limitations, 3-7 
types of, 3-7 
executive mode 
logical names, defining, 5—11 


F : 
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File I/O, 11-36 
CLOSE, 11-38 
OPEN, 11-37 
READ, 11-39 
WRITE, 11-40 
files 
blocks 
overwriting, deleted, 8-9 
creating 
overwriting blocks before allocating, 
8-9 : 
deleted 
erasing, 8-9 
paging 
installing, with SYPAGSWPFILES.COM, 
5-13 
swapping 
installing, with SYPAGSWPFILES.COM, 
5-13 


G 


generic print queues 
creating, 3-16 
creating (table), 3-16 
generic queues 
batch, 3-8 
description, 3-6 
function, 3-8 
output, 3-8 
types(table), 3-8 
GOSUB command 
command procedures 
flow of execution, 11-44 
GOTO Command 
command procedures 
flow of execution, 11—29 
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hardware controller code 
device names, 1-5 


VO, 11-36 
drivers 
loading, 5-8 
IF command 
command procedures 
flow of execution, 11-27 
images 
installation 
SYSTARTUP_V5.COM function, 5-14 
installing 
STARTUP.COM function, 5-7 


INITIALIZE command 
activating paging and swapping files with, 
5-13 
qualifiers 
/ENABLE_GENERIC, 3-16 
/GENERIC, 3-16 
/NOENABLE_ GENERIC, 3-16 
/QUEUE, 3-16, 3-23 
/QUEUE/GENERIC, 3-16 
/QUEUE/SEPARATION, 3-25 
intruder lists 
detecting break-in attempts with, 8-20 


J 


Job status codes 
(table), 3-22 
jobs 
moving from one queue to another (table), 
3-32 
JOB_CONTROL process 
print symbiont processes and 
(example), 3—11 
started up by STARTUP.COM, 5-7 
when records written to ACCOUNTING.DAT 
file, 7—4 


L 


LAT (Local Area Transport) network 
starting up 
SYSTARTUP_V5.COM function, 5-14 
layered products 
information about contained in 
VMS$LAYERED.DAT, 5-7 
installing, 6-6 — 
Lexical functions 
F$TIME, 11-33 
overview, 11-31 
Lexical Functions 
character manipulation, 11-32 
character manipulation example, 11-32 
f$edit, 11-71 
f$environment, 11-61 
f$extract, 11-72 
f$fao, 11—72 
f$getdvi, 11-67 
f$getjpi, 11-62 
f$getsyi, 11-34 
f$integer, 11-73 
f$length, 11-73 
f$locate, 11-74 
f$message, 11-68 
f$mode, 11-63 
f$parse, 11-77 
f$process, 11-64 
f$search, 11-78 


Lexical Functions (cont'd) 
f$time, 11-68 
f$trnlnm, 11-69 
f$user, 11-65 
f$verify, 11-65 
file information, 11-76 
process information, 11-60: 7 
system information, 11-66 ire 

LICENSE utility . 
characteristics, 6-12 
usage, 6-12 

LICENSE utility commands 
LIST, 6-12 
LOAD, 6-12 
START, 6-12 
UNLOAD, 6-12 

licenses 
activity license 

LURT values (table), 6-11 
displaying 
active, 6-12 
listing of, 6-12 
keys 
installation required for most Digital 
product, 6-8 
units 
moving software between processors 
with, 6-10 
required per user (table), 6-11 

LMF (License Management Facility) 
components of, 6—9 
managing product licenses with, 6-8 

Logical name tables, 2-5 
contents of, 2-8 
translation, 2-9 

Logical name translation, 2—11 

logical names 
assigning, to VMS system directories, 5-7 
assigning, to VMS system software, 5-7 
defining, system-wide, 5-9 
executive mode 

defining, 5-11 
system wide 

security, 5-9 
system-wide 

assigning(table), 5-9 

Logical names 
CONCEAL attribute example, 2-12 
duration of, 2-20 
redefining SYS$INPUT, 2-18, 11-41 
system, 2-19 
system-created, 2-16 

login 
failures 

recording in suspect lists, 8-17 
security 
as system integrity procedure, 8-11 
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LURT (License Unit Requirement Table) 
characteristics, 6—9 


MONITOR Utility 
characteristics and use, 10-5 
command procedures, 10-29 
command summary, 10-14 
monitoring a VAXcluster system, 10-10 
MOUNT command 
activating paging and swapping files with, 
5-13 
qualifiers 
' /BIND, 1-18 
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NETPROXY.DAT 
security procedures, 8-7 
NETPROXY.DAT file 
using executive-mode logical names for, 
5-11 
nodes 
name suspect list 
detecting break-in attempts with, 
8-17 
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OPCOM (OPerator COMmunication 
process) 
started up by STARTUP.COM, 5-7 
OPEN command, 11-37 
OPER privilege 
required for 
queue creation, 3-13 
OPERATOR.LOG 
purging 
unwanted, SYSTARTUP_V5.COM 
function, 5-14 
output execution queue 
function and limitations, 3-7 
printer execution queues, 3-7 
server execution queues, 3-7 
terminal execution queues, 3-7 
types, 3-7 
Overlays 
arithmetic, 11-59 
string, 11-58 
symbol, 11-57 


p 


PAGEFILE.SYS file 
activated by STARTUP.COM, 5-13 
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paging files 
specification and function (table), 5-19 
Parameters 
command procedures, 11-7 
passwords 
as login security, 8-11 
defining 
(table), 8-11 
password-collecting programs 
protecting terminals from, 8-16 
requesting 
secondary, as security procedure, 8—7 
system 
defining (table), 8-12 
using 
(table), 8—11 
PRINT command 
placing jobs in print queues with, 3-9 
print jobs 
maximum and minimum allowed sizes, 
print queue attribute, modifying, 3-23 
monitoring, 3-19 
number of separation pages for, print queue 
attribute, modifying, 3-23 
print queue attributes 
base priority 
modifying, 3-23 
owner 
modifying, 3-23 
print queues 
creating, with command files, 3-13 
definition, 3-9 
monitoring, 3-19 
PRINT command, 3-9 
scheduling, 3-11 
setting attributes, 3-23 
printer execution queues 
use of symbionts, 3-7 
printer form definition 
modifying, 3-23 
printers 
COPY command, 3-9 
spooled, 3-9 
print queue attribute, modifying, 3-23 
print queues, 3-9 
advantages, 3-9 
WRITE command, 3-9 
spooled, 3-9 
privileges 
needed to run LICENSE, 6-12 
process 
creating 
logical name for command procedure 
that handles 
(table), 5-9 
information 


process 
information (cont'd) 
collecting, with ACCOUNTING utility, 
7-4 
Product Authorization Key (PAK) 
installing license keys with, 6-8 
product licenses 
managing, 6-8 
protection 
user categories 
determining needs (table), 8-24 
protection codes 
print queue attribute 
modifying, 3-23 
public disks 
mounting 
SYSTARTUP_V5.COM function, 5-14 
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queue database, 3-5 
queue file 
creating, 3-5 
queue manager 
starting, 3-5 
queues 
automatic creation, 3-18 
creating queue file, 3-5 
execution 
effect of moving jobs on, 3-33 
initializing 
SYSTARTUP_V5.COM function, 5-14 
JOB_CONTROL 
system process, 3-5 
modifying attributes when running(table), 
3-23 
modifying attributes when stopped(table), 
3-23 
QUEUE_MANAGER 
system process, 3-5 
starting 
command functions 
(table), 3-13 
SYSTARTUP_V5.COM function, 5-14 
stopping 
necessary before deleting them, 3-33 
types, 3-6 
action (table), 3-6 
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READ, 11-37 
READ command, 11-39 
Restoring files 
from an image backup, 4-13 
RIGHTSLIST.DAT file 
using executive-mode logical names for, 
5-11 
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scheduling 
print jobs, 3-11 
Search lists, 2-13 * 
secure server characteristics 
setting, 8-16 
security 
auditing 
as security procedure, 8-7 
break-in detection, 8-7 
login, 8-17 she, “i 
defining executive-mode logical names, 5-9 
issues 
physical, 8-6 
labeling disks and tapes, 8-7 
log 


i ra yf 
f 


checking, for break-in attempts, 8-17 
login, 8-7 - 
media storage issues, 8-6 
periodic reports on usage, 8—7 
physical 
procedures, 8-6 
procedures, 8—7 
risk 
dial-up lines as, 8-6 
software 
procedures, 8-7 
SYSGEN parameters for break-in, 8-17 
separation pages 
/DEFAULT qualifier, 3-25 
specifying, 3~25 
SET ACCOUNTING command 
controlling I/O to ACCOUNTING.DAT file, © 
7-4 
SET DEVICE command 
qualifiers 
/ACL, 8-15 
SET FILE Command, 1-29 to 1-32 
SET PROTECTION command 
qualifiers 
/DEVICE, 8-15 
SET QUEUE command 
qualifiers 
/SEPARATION, 3-25 
when to use (table), 3-23 
SET TERMINAL command 
setting secure server characteristic with, 
8-16 
SET VOLUME command 
qualifiers 
/NOHIGHWATER_MARKING, 8-9 
SHOW CLUSTER Command, 10-24 
SHOW ENTRY command 
monitoring jobs with, 3-22 
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SHOW LICENSE command 
using) 6-12 ~ 2’ 
SHOW MEMORY command 
output - 
(example), 10-15 
SHOW PROCESS command 
qualifiers . 
/CONTINUOUS, 10-19 
SHOW QUEUE command 
monitoring queue status with, 3-19 
qualifiers. S2 . 
for displaying amount of queue 
information 
(table), 3-19 
for displaying queue types 
| (table), 3-19 
for displaying types of queues 
. (table), 3-19 
site-specific command procedure 
functions, 5-14 
software 
security 
"procedures, 8-7 
spooling 
COPY command, 3-9 
WRITE command, 3-9 
START command 
qualifiers 
/QUEUVE, 3-23 
/QUEUE/MANAGER, 3-5 
START QUEUE command 
qualifiers 
/SEPARATION, 3-25 
startup command procedure 
calling site-specific STARTUP.COM 
function, 5-7 
STARTUP$SAUTOCONFIGURE_ALL 
symbol 
suppressing autoconfiguration of devices 
with, 5-8 
STARTUP.COM 
CONFIGURE section 
disabling of, 5-8 
overriding with SYCONFIG.COM and 
SYSTARTUP_V5.COM, 5-7 
use for initializing VMS, 5-7 
String operations 
concatenation, 11-19 
reduction, 11-19 
Strings 
comparisons, 11-22 
manipulation, 11-20 
overlays, 11-58 
swap file 
installing 
with SYPAGSWPFILES.COM, 5-13 
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SWAPFILE.SYS file 
activated by STARTUP.COM, 5-13 
swapping file 
specification and function (table), 5-19 
SYCONFIG.COM 
configuring devices with, 5-8 
overriding STARTUP.COM with, 5-7 
suppressing autoconfiguration with, 5-8 
SYLOGICALS.COM 
defining system-wide logical names with, 
5-9 
symbionts 
execution queues use of, 3-7 
Symbol tables 
definition, 11-17 
Symbols 
arithmetic operations, 11—21 
arithmetic overlays, 11-59 
definition, 11-17 
global, 11-54 
local, 11-54 
operations, 11-19 
overlays, 11-57 
phases of command processing, 11—56 
string comparisons, 11—22 
string manipulation, 11-20 
string overlays, 11-58 
substitution, 11-9 
SYPAGSWPFILES.COM 
installing paging and swapping files with, 
5-13 
SYS$SANNOUNCE logical name 
defining 
(table), 5-9 
SYS$MANAGER 
site-specific files located in, 5—6 
SYSS$MANAGER:ACCOUNTING.DAT 
contents, 7—4 
system accounting 
uses, 7-4 
SYS$MANAGER:SYPAGSWPFILES.COM 
installing paging and swapping files with, 
5-13 
SYS$STARTUP logical name 
use with STARTUP.COM component files, 
5-7 
SYS$SYLOGIN logical name 
defining 
(table), 5-9 
SYS$SYSTEM:SHUTDOWN procedure 
stopping all queues, 3-18 
SYS$SYSTEM:STARTUP.COM 
system startup file, 5-6 
SYS$SYSTEM:SYCONFIG.COM 
system startup file, 5-6 
SYSSSYSTEM:SYLOGICALS.COM 
system startup file, 5-6 


SYS$SYSTEM:SYPAGSWPFILES.COM 
system startup file, 5-6 
SYS$SYSTEM:SYSGEN.EXE 
using when system resources change, 5-21 
SYS$SYSTEM:SYSTARTUP_V5.COM 
system startup file, 5-6 
SYS$UPDATE:AUTOGEN.COM 
modifying when system resources change, 
5-21 
SYS$UPDATE:VMSINSTAL command file 
installing layered products with, 6-6 
SYSSUPDATE:VMSLICENSE.COM 
registering the PAK for layered products, 
SYS$WELCOME logical name 
defining 
(table), 5-9 
SYSBOOT utility 
conversational startup 
using when system resources change, 
5-21 
SYSDUMP.DMP file 
activated by STARTUP.COM, 5-13 
SYSGEN command 
activating paging and swapping files with, 
5-13 
SYSGEN parameters 
file 
device configuration use of, 5-9 
for break-in, 8-17 
SYSMAN utility 
managing of VMS$LAYERED.DAT data 
file, 5-7 
SYSNAM privilege 
permits 
running of LICENSE, 6-12 
SYSPRV privilege 
ACL protection as alternative, 8—27 
permits 
running of LICENSE, 6-12 
SYSTARTUP_V5.COM 
as a shell procedure 
benefits of, 5-14 
automatic queue creation in, 3-18 
overriding STARTUP.COM with, 5-7 
SYSTARTUP_V5.COM command 
procedure 
listing of 
(example), 5-14 
site-specific startup functions of, 5-14 
system availability 
announcing 
SYSTARTUP_V5.COM function, 5-14 
system failure 
analyzing, SYSTARTUP_V5.COM function, 
5-14 


system files 


that affect system performance perenne 


and function (table), 5- 19 
system integrated products : 
list of, 6-6 
system parameters 
maintaining, 5-19 


anes 


recomputing when physical system ates 


resources change, 5-21 
system resources 


cs me 


ge 


information on usage and users, maintained 
in ACCOUNTING. DAT file, TA 


System Resources 


usage, displaying information about, 10-5 


system startup file 
command procedure 


creating print queues with, 3-13 
SYS$SYSTEM:STARTUP.COM, 5-6 
SYS$SYSTEM:SYCONFIG.COM, 5-6 


SYS$SYSTEM:SYLOGICALS.COM, 


5-6 


SYS$SYSTEM:SYPAGSWPFILES. COM, | 


5-6 


SYS$SYSTEM:SYSTARTUP_V5.COM, 5-6 
SYSUAF executive-mode logical name 


for SYSUAF.DAT, 5-11 


SYSUAF executive-mode system logical 


name 


defined in SYLOGICALS.COM, 5-11 


SYSUAF.dat 
restricting access, 8—7 
SYSUAF.DAT 


login security maintenance with, 8—11 


security procedures, 8-7 
SYSUAE.DAT file 


using executive-mode logical names for, 


5-11 
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terminal execution queues 
use of symbionts, 3-7 
Terminal I/O, 11-11 
displaying information, 11-13 
getting information from the user, 
terminal name . 
suspect list 


11-15 


detecting break-in attempts with, 


8-17 
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VIC (User Identification Code) 
protection 


system protection procedures using, 


8-24 
setting 
up group, 8-24 
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UIC-based protection 
files (table), 8—23 
unit number 
device names, 1—5 
user name 
as login security, 8-11 
suspect list 
detecting break-in attempts with, 
8-17 
users 
allowing to log in 
SYSTARTUP_V5.COM function, 5~14 
chapt title, 1-3, 3-3, 4-3 
defining 
maximum number of interactive, 
SYSTARTUP_V5.COM function, 
5-14 
removing 
old, as security procedure, 8—7 


V 
VMS operating system 
initializing 
STARTUP.COM use for, 5-7 
phased startup 
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files involved with, 5—7 
protection, using UICs, 8-24 
starting up 

procedures, 5-6 

VMSS$LAYERED.DAT file 
phased system startup file, 5—7 
warning against modification, 5—7 
VMS$PHASES.DAT file 
phased system startup file, 5-7 
warning against modification, 5—7 
VMS$VMS.DAT 
warning against modification, 5-7 
VMSS$VMS.DAT data file 
_ phased system startup file, 5— 
VMSMAIL.DAT file 
using executive-mode logical names for, 
5-11 
volumes 
‘binding, 1-18 
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WRITE command 
spooling, 3-9 
WRITE command, 11-40 


